Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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 界面。
对实施与开发的价值
实施阶段
- 快速验证配置：用自然语言直接查数据，无需登录 ERP 界面逐层点菜单
- 数据核查：批量查询单据状态、库存数量，快速定位问题
- 客户演示：现场说"查一下你们的采购订单"，AI 实时返回结果，演示效果直观
日常使用
- 业务人员自助查询，减少依赖实施人员的频率
- 批量提交、审核单据，替代重复的手工操作
- 通过微信 / WhatsApp 直接操作金蝶，无需打开 ERP 客户端
开发阶段
- 用
kingdee_list_forms、kingdee_get_fields快速探索表单结构，替代翻文档 - 自然语言调试接口，比手写 API 请求效率更高
- 可作为内部工具基础进行二次开发，快速扩展自定义工具
支持的 AI 客户端
| 客户端 | 支持方式 |
|---|---|
| Claude Desktop | 原生 MCP |
| Cursor | 原生 MCP |
| Windsurf | 原生 MCP |
| Cline | 原生 MCP |
| Continue | 原生 MCP |
| Claude Code CLI | 原生 MCP |
| OpenClaw | 微信/WhatsApp/Telegram 中使用；将本页地址发给 OpenClaw，它会自动完成安装并引导填写金蝶配置 |
| 其他 MCP 兼容客户端 | 原生 MCP |
功能特性
- 20 个 ERP 操作工具：涵盖采购、销售、库存、基础资料等核心业务
- 4 个 SQL Server 探查工具：搜索表、搜索字段、查看表结构、金蝶元数据候选发现
- 自然语言操作：用中文直接描述需求，AI 自动转换为 API 调用
- 异步高性能：基于 async/await，支持并发请求
- 自动重试：Session 过期自动重登，连接失败自动重试
- 安全认证：采用金蝶官方 WebAPI 认证，支持 AppSecret 方式，兼容公有云和私有云
- 类型安全：基于 Pydantic 数据验证，参数自动补全
- 易于扩展：基于 FastMCP 框架，轻松添加自定义工具
- 使用示例：提供 9 个常见业务场景示例，覆盖查询、新建、审核、下推等操作
快速安装
pip install kingdee-mcp或使用 uvx 直接运行（推荐，无需手动安装）：
uvx kingdee-mcp配置教程
第一步：金蝶云星空后台授权
- 进入 系统管理 → 第三方系统登录授权 → 新增
- 新建一个集成用户（不要用 Administrator）
- 生成 AppID 和 AppSecret
- 为该用户分配所需模块的操作权限
第二步：配置 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 set 命令配置，自动热加载无需重启 |
第三步：重启客户端
配置完成后重启你的 MCP 客户端即可开始使用。
OpenClaw 用户：使用 openclaw mcp set 配置后会自动热加载，无需重启网关。环境变量说明
| 变量 | 说明 | 示例 |
|---|---|---|
KINGDEE_SERVER_URL | 金蝶服务器地址（需包含 /k3cloud/） | http://your-server/k3cloud/ |
KINGDEE_ACCT_ID | 账套ID | your-acct-id |
KINGDEE_USERNAME | 集成用户名 | your-username |
KINGDEE_APP_ID | 应用ID | your-app-id |
KINGDEE_APP_SEC | 应用密钥（AppSecret） | your-app-secret |
MCP_SQLSERVER_HOST | SQL Server 主机（可选，用于数据库探查） | localhost |
MCP_SQLSERVER_PORT | SQL Server 端口（默认 1433） | 1433 |
MCP_SQLSERVER_DATABASE | 数据库名 | AIS20260309171043 |
MCP_SQLSERVER_USER | SQL Server 用户（建议只读账号） | sa |
MCP_SQLSERVER_PASSWORD | SQL Server 密码 | xxxx |
可用工具列表
元数据查询
| 工具名称 | 功能说明 |
|---|---|
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
反审核销售订单 SO2024001SQL Server 探查工具（可选）
配置 MCP_SQLSERVER_* 环境变量后可用，帮助理解金蝶数据库结构：
| 工具名称 | 功能说明 |
|---|---|
kingdee_discover_tables | 按关键字搜索数据库表名 |
kingdee_discover_columns | 按关键字搜索字段名（含所在表） |
kingdee_describe_table | 查看表完整结构（字段、类型、主键、外键） |
kingdee_discover_metadata_candidates | 根据 form_id 发现对应的数据库表名 |
典型用法：先问 AI "采购订单在数据库里对应哪张表"，再用 kingdee_describe_table 看字段结构。
支持的单据类型（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: 支持金蝶云星空公有云吗？ 支持。公有云和私有云使用相同的 AppSecret 认证方式，配置方式完全一致。
配合 mcp-sqlserver-introspect 使用
kingdee-mcp 提供两层能力：
第一层：ERP 操作层（kingdee-mcp 内置） 直接操作金蝶单据：查询、新建、提交、审核、下推等。
第二层：数据库理解层（mcp-sqlserver-introspect） 探查 SQL Server 表结构：找表、找字段、理解关联关系。
典型使用场景：
# 场景一：接口映射
问："帮我找采购订单相关的表"
→ mcp-sqlserver-introspect 返回 T_PUR_PurchaseOrder 等表
→ 确认 Kingdee API 字段和数据库字段的对应关系
# 场景二：字段溯源
问："帮我查 FTotalAmount 这个字段在哪些表里"
→ mcp-sqlserver-introspect 返回包含该字段的表列表
# 场景三：数据核查
先用 mcp-sqlserver-introspect 探索表结构
再用 kingdee-mcp 操作 ERP 数据
两者配合，AI 既能理解数据库，又能操作 ERPmcp-sqlserver-introspect 项目地址：https://gitee.com/lzhrick123/mcp-sqlserver-introspect1
kingdee-mcp 已内置 SQL Server 探查工具（配置 MCP_SQLSERVER_* 环境变量即可使用），无需额外安装 mcp-sqlserver-introspect。Q: 如何添加自定义工具？ 基于 FastMCP 框架，在 server.py 中添加 @mcp.tool() 装饰器方法即可扩展。
相关链接
License
MIT © WaHaiLong