Kingdee MCP Server —— 让 AI 直接操作金蝶云星空 ERP

⚠️ 本项目为第三方开源，非金蝶官方出品，与金蝶软件（Kingdee）无任何隶属或授权关系。

Kingdee MCP Server 是金蝶云星空（Kingdee Cloud Star）ERP 的 MCP（Model Context Protocol） 服务端，让 Claude、Cursor、Windsurf、Cline 等 AI 助手能够通过自然语言直接操作金蝶 ERP 系统。

官方网站：https://wahailong.github.io/KingdeeMCP/

为什么需要金蝶 MCP？

传统 ERP 操作繁琐，需要在多个界面间切换。有了 金蝶 MCP Server，你可以：

• 直接对 AI 说："查询本月已审核的采购订单"
• 直接对 AI 说："帮我新建一张销售订单"
• 直接对 AI 说："审核这几张入库单"
• 在微信、WhatsApp、Telegram 中通过 OpenClaw 操作金蝶

AI 会自动调用金蝶 API 完成操作，无需手动登录 ERP 界面。

对实施与开发的价值

实施阶段

• 快速验证配置：用自然语言直接查数据，无需登录 ERP 界面逐层点菜单
• 数据核查：批量查询单据状态、库存数量，快速定位问题
• 客户演示：现场说"查一下你们的采购订单"，AI 实时返回结果，演示效果直观

日常使用

• 业务人员自助查询，减少依赖实施人员的频率
• 批量提交、审核单据，替代重复的手工操作
• 通过微信 / WhatsApp 直接操作金蝶，无需打开 ERP 客户端

开发阶段

• 用 kingdee_list_forms、kingdee_get_fields 快速探索表单结构，替代翻文档
• 自然语言调试接口，比手写 API 请求效率更高
• 可作为内部工具基础进行二次开发，快速扩展自定义工具

支持的 AI 客户端

客户端	支持方式
Claude Desktop	原生 MCP
Cursor	原生 MCP
Windsurf	原生 MCP
Cline	原生 MCP
Continue	原生 MCP
Claude Code CLI	原生 MCP
OpenClaw	微信/WhatsApp/Telegram 中使用；将本页地址发给 OpenClaw，它会自动完成安装并引导填写金蝶配置
其他 MCP 兼容客户端	原生 MCP

功能特性

• 87 个工具：覆盖生产、成本、资产、审计、采购、销售、库存、财务报表等 13+ 大业务域
• 元数据动态查询：get_bill_template / validate_bill / refresh_metadata，元数据本地缓存
• 4 个 SQL Server 探查工具：搜索表、搜索字段、查看表结构、金蝶元数据候选发现
• 自然语言操作：用中文直接描述需求，AI 自动转换为 API 调用
• 异步高性能：基于 async/await，支持并发请求
• 自动重试：Session 过期自动重登，连接失败自动重试
• 安全认证：采用金蝶官方 WebAPI 认证，账号密码(ValidateUser)登录，兼容公有云和私有云，无第三方应用授权
• 类型安全：基于 Pydantic 数据验证，参数自动补全
• 易于扩展：基于 FastMCP 框架，轻松添加自定义工具
• 使用示例：提供 9 个常见业务场景示例，覆盖查询、新建、审核、下推等操作

快速安装

pip install kingdee-mcp

或使用 uvx 直接运行（推荐，无需手动安装）：

uvx kingdee-mcp

远程部署（HTTP / SSE 模式）

默认以 stdio 模式运行（本地 MCP 客户端通过子进程调用）。若要把服务部署到服务器、或用网关/托管平台（如 Smithery）远程调用、免客户端安装，可改用 HTTP 类传输：

# SSE 模式（兼容性好，旧客户端首选）
uvx kingdee-mcp --transport sse --host 0.0.0.0 --port 8000

# Streamable HTTP 模式（MCP 新版推荐）
uvx kingdee-mcp --transport streamable-http --host 0.0.0.0 --port 8000

• SSE 端点：http://<host>:/sse
• Streamable HTTP 端点：http://<host>:/mcp

远程模式下仍需金蝶账号密码（通过 KINGDEE_* 环境变量注入）。HTTP 只是传输通道，并不替代金蝶认证——客户端连上来后，工具调用照样要走金蝶 ValidateUser 登录。

也可用环境变量代替命令行参数：KINGDEE_MCP_TRANSPORT（stdio/sse/streamable-http）、KINGDEE_MCP_HOST、KINGDEE_MCP_PORT。

配置教程

第一步：金蝶云星空后台授权

1. 准备一个金蝶云星空账号（建议专用集成账号，不要用 Administrator）
2. 本服务采用**账号密码(ValidateUser)**登录，无需创建第三方应用、也无需 AppID / AppSecret
3. 为该账号分配所需模块的操作权限

第二步：配置 MCP 客户端

在你的 MCP 客户端配置文件中添加以下内容：

{
  "mcpServers": {
    "kingdee": {
      "command": "uvx",
      "args": ["kingdee-mcp"],
      "env": {
        "KINGDEE_SERVER_URL": "http://your-server/k3cloud/",
        "KINGDEE_ACCT_ID": "你的账套ID",
        "KINGDEE_USERNAME": "金蝶账号",
        "KINGDEE_PASSWORD": "金蝶账号密码"
      }
    }
  }
}

配置文件位置：

客户端	配置文件路径
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
Claude Desktop (macOS)	~/Library/Application Support/Claude/claude_desktop_config.json
Cursor	Settings → MCP → Add Server
Claude Code CLI	~/.claude/settings.json
OpenClaw	使用 openclaw mcp set 命令配置，自动热加载无需重启