让 AI 直接操作
金蝶云星空
金蝶云星空 ERP 的 MCP Server，支持 Claude Desktop、Cursor、Windsurf、OpenClaw 等所有 MCP 兼容客户端。通过 OpenClaw 还可以在 微信、WhatsApp、Telegram 中直接操作金蝶。
pip install kingdee-mcp
为什么选择 Kingdee MCP
简单、高效、安全地让 AI 助手接入你的金蝶系统
异步高性能
基于 async/await 异步架构，支持并发请求，自动 Session 缓存和重试机制。
86 个实用工具
覆盖生产、成本、资产、审计、采购、销售、库存等 13 大业务域，开箱即用。
安全认证
采用金蝶官方 WebAPI 认证，账号密码(ValidateUser)登录，凭证本地存储，无第三方应用授权。
自动重试
Session 过期自动重新登录，连接失败自动重试，稳定可靠。
类型安全
基于 Pydantic 的数据验证，所有输入参数都有类型检查和自动补全。
易于扩展
基于 FastMCP 框架，轻松添加自定义工具和业务逻辑。
支持的工具列表
共 86 个工具，覆盖 13 大业务域
快速安装
只需几步，即可让 AI 连接你的金蝶系统
安装 MCP Server
确保已安装 Python 3.10+，通过 pip 安装。
pip install kingdee-mcp准备金蝶账号
准备一个金蝶云星空账号（建议专用集成账号，不要用 Administrator）。
本服务采用账号密码(ValidateUser)登录，无需在「第三方系统登录授权」中创建应用、也无需 AppID / AppSecret，只要该账号有对应模块的操作权限即可。
配置 MCP 客户端
在你的 MCP 客户端配置文件中添加以下内容。
{
"mcpServers": {
"kingdee": {
"command": "uvx",
"args": ["kingdee-mcp"],
"env": {
"KINGDEE_SERVER_URL": "http://your-server/k3cloud/",
"KINGDEE_ACCT_ID": "your_acct_id",
"KINGDEE_USERNAME": "金蝶账号",
"KINGDEE_PASSWORD": "金蝶账号密码"
}
}
}
}
配置文件位置：
Claude Desktop (Win): %APPDATA%\Claude\claude_desktop_config.json
Claude Desktop (Mac): ~/Library/Application Support/Claude/claude_desktop_config.json
Cursor: Settings → MCP → Add Server
Claude Code CLI: ~/.claude/settings.json
重启客户端
完成配置后，重启你的 MCP 客户端即可开始使用。
安全提示
请确保 .env 文件不会被提交到代码仓库。建议将其加入 .gitignore。
使用示例
配置完成后，直接用自然语言与 AI 交互
kingdee_query_purchase_orders(
top: 20,
filter_string: "FDocumentStatus = 'C'",
order_by: "FDate DESC"
)kingdee_query_inventory(
filter_string: "FMaterialNumber = 'MAT001'"
)kingdee_query_sale_orders(
filter_string: "FSupplierNumber = 'C001'"
)kingdee_save_bill(
form_id: "PUR_PurchaseOrder",
data: {
FSupplierId: { FNumber: "S001" },
FMaterialId: { FNumber: "MAT001" },
FQty: 100,
FTaxPrice: 10.5
}
)kingdee_audit_bills(
form_id: "STK_Instock",
bill_ids: ["12345", "12346"]
)kingdee_unaudit_bills(
form_id: "SAL_SaleOrder",
bill_ids: ["SO2024001"]
)更新日志
持续迭代，最新能力一览
常见问题
遇到问题？这里可能有答案
FDocumentStatus = 'C' 表示已审核状态。