kingdee-mcp 0.1.0

MCP Server for Kingdee Cloud K/3 - Works with any MCP-compatible AI client

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 客户端

客户端	支持方式
Claude Desktop	原生 MCP
Cursor	原生 MCP
Windsurf	原生 MCP
Cline	原生 MCP
Continue	原生 MCP
Claude Code CLI	原生 MCP
OpenClaw	微信/WhatsApp/Telegram 中使用
其他 MCP 兼容客户端	原生 MCP

功能特性

• 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"
      }
    }
  }
}

配置文件位置：

客户端	配置文件路径
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 文档

第三步：重启客户端

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

环境变量说明

变量	说明	示例
KINGDEE_SERVER_URL	金蝶私有云服务器地址（需包含 /k3cloud/）	http://192.168.1.100/k3cloud/
KINGDEE_ACCT_ID	账套ID	69ae8ed35dab20
KINGDEE_USERNAME	集成用户名	API集成
KINGDEE_APP_ID	应用ID	338898_xxxxx
KINGDEE_APP_SEC	应用密钥（AppSecret）	f8b75d4ccxxxx

可用工具列表

元数据查询

工具名称	功能说明
kingdee_list_forms	搜索可用表单（不知道 form_id 时使用）
kingdee_get_fields	获取表单字段列表

数据查询（只读操作）

工具名称	功能说明
kingdee_query_bills	通用单据查询，支持任意 form_id
kingdee_view_bill	查看单据完整详情
kingdee_query_purchase_orders	查询采购订单
kingdee_query_sale_orders	查询销售订单
kingdee_query_stock_bills	查询出入库单据
kingdee_query_inventory	查询即时库存
kingdee_query_materials	查询物料档案
kingdee_query_partners	查询客户/供应商档案

单据操作（写操作）

工具名称	功能说明
kingdee_save_bill	新建或修改单据
kingdee_submit_bills	提交单据
kingdee_audit_bills	审核单据
kingdee_unaudit_bills	反审核单据
kingdee_delete_bills	删除单据

使用示例

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

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

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

支持的单据类型（form_id）

form_id	说明
PUR_PurchaseOrder	采购订单
SAL_SaleOrder	销售订单
STK_InStock	采购入库单
SAL_OUTSTOCK	销售出库单
STK_MisDelivery	其他出库单
STK_Miscellaneous	其他入库单
STK_TransferDirect	直接调拨单
BD_Material	物料档案
BD_Customer	客户档案
BD_Supplier	供应商档案
STK_Inventory	即时库存

常见问题

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

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

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

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

相关链接

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

License

MIT © WaHaiLong