kingdee-mcp-saas

# Kingdee MCP Server —— 让 AI 直接操作金蝶云星空 ERP **Kingdee MCP Server** 是金蝶云星空（Kingdee Cloud Star）ERP 的 [MCP（Model Context Protocol）](https://modelcontextprotocol.io/) 服务端，让 Claude、Cursor、Windsurf、Cline 等 AI 助手能够通过自然语言直接操作金蝶 ERP 系统。 ## 为什么需要金蝶 MCP？ 传统 ERP 操作繁琐，需要在多个界面间切换。有了 **金蝶 MCP Server**，你可以： - 直接对 AI 说："**查询本月已审核的采购订单**" - 直接对 AI 说："**帮我新建一张销售订单**" - 直接对 AI 说："**审核这几张入库单**" - 在微信、WhatsApp、Telegram、飞书 中通过 OpenClaw 操作金蝶 AI 会自动调用金蝶 API 完成操作，无需手动登录 ERP 界面。 ## 支持的 AI 客户端 | 客户端 | 支持方式 | |--------|---------| | [Claude Desktop](https://claude.ai/download) | 原生 MCP | | [Cursor](https://cursor.sh/) | 原生 MCP | | [Windsurf](https://codeium.com/windsurf) | 原生 MCP | | [Cline](https://github.com/cline/cline) | 原生 MCP | | [Continue](https://continue.dev/) | 原生 MCP | | [Claude Code CLI](https://claude.ai/claude-code) | 原生 MCP | | [OpenClaw](https://openclaw.ai/) | 微信/WhatsApp/Telegram 中使用 | | 其他 MCP 兼容客户端 | 原生 MCP | ## 功能特性 - **13+ 实用工具**：涵盖采购、销售、库存、基础资料等核心业务 - **自然语言操作**：用中文直接描述需求，AI 自动转换为 API 调用 - **异步高性能**：基于 async/await，支持并发请求 - **自动重试**：Session 过期自动重登，连接失败自动重试 - **安全认证**：采用金蝶官方 WebAPI 认证，支持 AppSecret 方式 - **类型安全**：基于 Pydantic 数据验证，参数自动补全 - **易于扩展**：基于 FastMCP 框架，轻松添加自定义工具 ## 快速安装 ```bash pip install kingdee-mcp-saas ``` 或使用 uvx 直接运行（推荐，无需手动安装）： ```bash uvx kingdee-mcp-saas ``` ## 配置教程 ### 第一步：配置 MCP 客户端 在你的 MCP 客户端配置文件中添加以下内容： ```json { "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 | 参考 [Op…