让 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 框架，轻松添加自定义工具和业务逻辑。
快速安装
只需几步，即可让 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。
📘 如果你用 WorkBuddy 接入，我们写了专属教程：在 WorkBuddy 中使用 kingdee-mcp →
使用示例
配置完成后，直接用自然语言与 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' 表示已审核状态。