金蝶云星空 K3Cloud MCP Server，让 AI 助手（Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Continue、Cherry Studio 等任意支持 MCP 协议的客户端）通过自然语言查询和操作金蝶 ERP 系统。标准
金蝶云星空 K3Cloud MCP Server，让 AI 助手（Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Continue、Cherry Studio 等任意支持 MCP 协议的客户端）通过自然语言查询和操作金蝶 ERP 系统。标准 PyPI 包，pip install 或 uvx 均可直接运行，无需绑定特定包管理器。. The kingdee k3cloud mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.
The server ships on PyPI as kingdee-k3cloud-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Everything the assistant can do here goes through one of these:
your — server 为金蝶云星空服务器的域名或 IP 地址KD_SERVER_URL — 金蝶服务器地址（必须以 /k3cloud/ 结尾）KD_ACCT_ID — 账套 IDKD_USERNAME — 集成用户账号KD_APP_ID — 应用 IDKD_APP_SEC — 应用密钥KD_LCID — 语言（默认 2052 中文）KD_ORG_NUM — 组织编码（可选）query_bill — 查询单据数据（返回二维数组）query_bill_json — 查询单据数据（返回 JSON，字段名作为 key）count_bill — 估算查询结果行数，用于大数据量查询前的探测query_bill_all — 自动翻页查询直到拉完或达到安全上限，返回合并结果You will need 8 environment variables: KD_SERVER_URL, KD_ACCT_ID, KD_USERNAME, KD_APP_ID, KD_APP_SEC, KD_LCID, MCP_MODE, FASTMCP_HOST. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Kingdee K3cloud MCP's toolset — your, KD_SERVER_URL, KD_ACCT_ID and 11 more — is a fair guide to whether it matches your workflow. It is maintained by adamzhang1987; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Kingdee K3cloud MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| your | server 为金蝶云星空服务器的域名或 IP 地址 |
| KD_SERVER_URL | 金蝶服务器地址（必须以 /k3cloud/ 结尾） |
| KD_ACCT_ID | 账套 ID |
| KD_USERNAME | 集成用户账号 |
| KD_APP_ID | 应用 ID |
| KD_APP_SEC | 应用密钥 |
| KD_LCID | 语言（默认 2052 中文） |
| KD_ORG_NUM | 组织编码（可选） |
| query_bill | 查询单据数据（返回二维数组） |
| query_bill_json | 查询单据数据（返回 JSON，字段名作为 key） |
| count_bill | 估算查询结果行数，用于大数据量查询前的探测 |
| query_bill_all | 自动翻页查询直到拉完或达到安全上限，返回合并结果 |
| query_bill_to_file | 自动翻页并流式写入本地文件（ndjson / csv），适合万行以上导出 |
| query_bill_range | 按日期自动分片（月/周/日）+ 翻页，适合跨月/跨年查询，支持落盘 |
{
"mcpServers": {
"kingdee-k3cloud": {
"command": "uvx",
"args": ["kingdee-k3cloud-mcp"],
"env": {
"KD_SERVER_URL": "your-value",
"KD_ACCT_ID": "your-value",
"KD_USERNAME": "your-value",
"KD_APP_ID": "your-value",
"KD_APP_SEC": "your-value",
"KD_LCID": "your-value",
"MCP_MODE": "your-value",
"FASTMCP_HOST": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| KD_SERVER_URL | Endpoint or connection string the server talks to. | Yes |
| KD_ACCT_ID | Configuration value read at startup. | Optional |
| KD_USERNAME | Configuration value read at startup. | Optional |
| KD_APP_ID | Configuration value read at startup. | Optional |
| KD_APP_SEC | Configuration value read at startup. | Optional |
| KD_LCID | Configuration value read at startup. | Optional |
| MCP_MODE | Configuration value read at startup. | Optional |
| FASTMCP_HOST | Endpoint or connection string the server talks to. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.