Kingdee MCP Server —— 让 AI 直接操作金蝶云星空 ERP
Kingdee MCP Server 是金蝶云星空（Kingdee Cloud Star）ERP 的 MCP（Model Context Protocol） 服务端，让 Claude、Cursor、Windsurf、Cline 等 AI 助手能够通过自然语言直接操作金蝶 ERP 系统。
为什么需要金蝶 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-saas
或使用 uvx 直接运行（推荐，无需手动安装）：
uvx kingdee-mcp-saas
配置教程
第一步：配置 MCP 客户端
在你的 MCP 客户端配置文件中添加以下内容：
{
"mcpServers": {
"kingdee": {
"command": "uvx",
"args": ["kingdee-mcp-saas"],
"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 文档 |
第二步：重启客户端
配置完成后重启你的 MCP 客户端即可开始使用。
环境变量说明
| 变量 | 说明 | 示例 |
|---|---|---|
KINGDEE_SERVER_URL |
金蝶私有云服务器地址（需包含 /k3cloud/） | http://192.168.1.100/k3cloud/ |
KINGDEE_ACCT_ID |
账套ID | 69ae8ed35dab20 |
KINGDEE_USERNAME |
登录用户名 | admin |
KINGDEE_PASSWORD |
登录密码 | 123456 |
可用工具列表
元数据查询
| 工具名称 | 功能说明 |
|---|---|
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() 装饰器方法即可扩展。
相关链接
License
MIT © WaHaiLong
1 maintainer
Metadata
1 maintainer
Release files for kingdee-mcp-saas 1.0.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| kingdee_mcp_saas-1.0.12.tar.gz | 15.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kingdee_mcp_saas-1.0.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 31.8 kB
Release files / kingdee_mcp_saas-1.0.12.tar.gz
| Download URL | kingdee_mcp_saas-1.0.12.tar.gz |
|---|---|
| Size | 15.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d74bd7165d13d3ea30bfb6bd9ad86012854a1b3f8b8748fd1db5be9aa42b9ed
|
|
BLAKE2b-256 checksum How to use checksums |
f7e01541fd6df4fc2ccd30b4cbf2839cce42b9851e699662e279719cbeace52b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.5
|
Release files / kingdee_mcp_saas-1.0.12-py3-none-any.whl
| Download URL | kingdee_mcp_saas-1.0.12-py3-none-any.whl |
|---|---|
| Size | 16.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cb3aad791100fcedb2f444a2e24b72045bf0f27076a7e5d91e580289c8b72b32
|
|
BLAKE2b-256 checksum How to use checksums |
18ecc503fbf7d1807cabc8f196d3be74be6d93057ab1b885388dbaabf19a6f7f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.5
|
Security for kingdee-mcp-saas 1.0.12
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
