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

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 界面。

支持的 AI 客户端

功能特性

• 13+ 实用工具：涵盖采购、销售、库存、基础资料等核心业务
• 自然语言操作：用中文直接描述需求，AI 自动转换为 API 调用
• 异步高性能：基于 async/await，支持并发请求
• 自动重试：Session 过期自动重登，连接失败自动重试
• 安全认证：采用金蝶官方 WebAPI 认证，支持 AppSecret 方式
• 类型安全：基于 Pydantic 数据验证，参数自动补全
• 易于扩展：基于 FastMCP 框架，轻松添加自定义工具

快速安装

pip install kingdee-mcp

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

uvx kingdee-mcp

配置教程

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

1. 进入 系统管理 → 第三方系统登录授权 → 新增
2. 新建一个集成用户（不要用 Administrator）
3. 生成 AppID 和 AppSecret
4. 为该用户分配所需模块的操作权限

第二步：配置 MCP 客户端

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

{
  "mcpServers": {
    "kingdee": {
      "command": "uvx",
      "args": ["kingdee-mcp"],
      "env": {
        "KINGDEE_SERVER_URL": "http://your-server/k3cloud/",
        "KINGDEE_ACCT_ID": "你的账套ID",
        "KINGDEE_USERNAME": "集成用户名",
        "KINGDEE_APP_ID": "AppID",
        "KINGDEE_APP_SEC": "AppSecret"
      }
    }
  }
}

配置文件位置：

第三步：重启客户端

配置完成后重启你的 MCP 客户端即可开始使用。

环境变量说明

可用工具列表

元数据查询

数据查询（只读操作）

单据操作（写操作）

使用示例

配置完成后，在 Claude 或其他 AI 客户端中直接用自然语言操作：

# 查询类
查询最近 20 条已审核的采购订单
查一下物料编码 MAT001 的即时库存
查询客户编码 C001 的所有销售订单
显示本月所有未提交的销售订单

# 操作类
帮我新建一张采购订单，供应商 S001，物料 MAT001，数量 100，单价 10.5
审核这几张采购入库单：12345, 12346, 12347
反审核销售订单 SO2024001

支持的单据类型（form_id）

常见问题

Q: 提示认证失败怎么办？
检查 AppID / AppSecret 是否正确，集成用户是否有对应模块的访问权限。

Q: 连接超时怎么解决？
检查 KINGDEE_SERVER_URL 是否正确（需包含 /k3cloud/ 后缀），确保服务器可访问。

Q: 支持金蝶云星空公有云吗？
目前主要针对私有云测试，公有云用户可能需要调整认证方式。

Q: 如何添加自定义工具？
基于 FastMCP 框架，在 server.py 中添加 @mcp.tool() 装饰器方法即可扩展。

相关链接

• 官方网站
• PyPI 包页面
• MCP 协议文档
• 金蝶云星空官网

License

MIT © WaHaiLong