kingdee-mcp 0.1.0__tar.gz

kingdee_mcp-0.1.0/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(cd:*)"
+    ]
+  }
+}

kingdee_mcp-0.1.0/.env.example

@@ -0,0 +1,17 @@
+# 金蝶云星空私有云连接配置
+# 复制本文件为 .env 并填入真实值
+
+# 私有云地址（末尾加 /k3cloud/）
+KINGDEE_SERVER_URL=http://192.168.1.100:8080/k3cloud/
+
+# 账套ID（金蝶管理中心 → 数据中心标识）
+KINGDEE_ACCT_ID=your_acct_id
+
+# 集成用户名（系统管理 → 第三方系统登录授权 → 集成用户，不要用 Administrator）
+KINGDEE_USERNAME=API集成
+
+# 应用ID（第三方系统登录授权生成）
+KINGDEE_APP_ID=your_app_id
+
+# 应用密钥（第三方系统登录授权生成）
+KINGDEE_APP_SEC=your_app_secret

kingdee_mcp-0.1.0/.github/workflows/deploy-pages.yml

@@ -0,0 +1,41 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - '.github/workflows/deploy-pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: 'docs'
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

kingdee_mcp-0.1.0/.github/workflows/static.yml

@@ -0,0 +1,43 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Upload entire repository
+          path: 'docs'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

kingdee_mcp-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Build
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+*.so
+
+# Virtual environments
+venv/
+.venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Sensitive files
+.env
+.mcp.json
+
+# OS
+.DS_Store
+Thumbs.db

kingdee_mcp-0.1.0/.mcp.json.example

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "kingdee": {
+      "command": "uvx",
+      "args": ["kingdee-mcp"],
+      "env": {
+        "KINGDEE_SERVER_URL": "http://your-server/k3cloud/",
+        "KINGDEE_ACCT_ID": "your-acct-id",
+        "KINGDEE_USERNAME": "your-username",
+        "KINGDEE_APP_ID": "your-app-id",
+        "KINGDEE_APP_SEC": "your-app-secret"
+      }
+    }
+  }
+}

kingdee_mcp-0.1.0/CLAUDE.md

@@ -0,0 +1,68 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+```bash
+# Install in development mode
+pip install -e .
+
+# Run the MCP server directly
+kingdee-mcp
+
+# Run with uvx (no install needed)
+uvx kingdee-mcp
+
+# Build distribution package
+pip install hatchling
+python -m hatchling build
+
+# Install with all deps
+pip install "mcp[cli]>=1.0.0" httpx pydantic
+```
+
+There are no tests in this project currently.
+
+## Architecture
+
+This is a single-file MCP Server (`src/kingdee_mcp/server.py`) that bridges AI clients to Kingdee Cloud K/3 ERP via its WebAPI.
+
+### Request Flow
+
+1. AI client calls a tool → FastMCP dispatches to the decorated async function
+2. Function calls `_post(ep_key, payload)` with a `[form_id, {params}]` list
+3. `_post()` checks the global `_session_id` cache; calls `_login()` if absent
+4. On 401 or session-expired response, auto re-logins and retries once
+5. All tools return JSON strings (success or error message from `_err()`)
+
+### Key Internals
+
+- **`_EP` dict** — maps short names (`"query"`, `"save"`, etc.) to full Kingdee WebAPI endpoint paths
+- **`_session_id` global** — cached session cookie (`kdservice-sessionid`) from `LoginByAppSecret`
+- **`FORM_CATALOG` dict** — maps `form_id` → `{name, alias[], fields}` used by `kingdee_list_forms` and `kingdee_get_fields` to help the AI discover form IDs without hitting the API
+- **Pydantic input models** — each tool has a dedicated model (`QueryInput`, `SaveInput`, `BillIdsInput`, etc.) with `extra="forbid"` for strict validation
+
+### Tool Categories
+
+| Category | Tools |
+|----------|-------|
+| Metadata | `kingdee_list_forms`, `kingdee_get_fields` |
+| Read-only queries | `kingdee_query_bills`, `kingdee_view_bill`, `kingdee_query_purchase_orders`, `kingdee_query_sale_orders`, `kingdee_query_stock_bills`, `kingdee_query_inventory`, `kingdee_query_materials`, `kingdee_query_partners` |
+| Write operations | `kingdee_save_bill`, `kingdee_submit_bills`, `kingdee_audit_bills`, `kingdee_unaudit_bills`, `kingdee_delete_bills`, `kingdee_push_bill` |
+| Workflow | `kingdee_query_pending_approvals`, `kingdee_query_workflow_status`, `kingdee_workflow_approve`, `kingdee_query_expense_reimburse` |
+
+### Environment Variables (required at runtime)
+
+| Variable | Description |
+|----------|-------------|
+| `KINGDEE_SERVER_URL` | Server URL ending in `/k3cloud/` |
+| `KINGDEE_ACCT_ID` | Account set ID |
+| `KINGDEE_USERNAME` | Integration user name |
+| `KINGDEE_APP_ID` | App ID from Kingdee admin |
+| `KINGDEE_APP_SEC` | App Secret from Kingdee admin |
+
+### GitHub Pages (`docs/`)
+
+The website at `https://wahailong.github.io/KingdeeMCP/` is a single static HTML file (`docs/index.html`). The deploy workflow (`.github/workflows/deploy-pages.yml`) triggers on push to `main` branch — **note the repo uses `master`**, so the workflow must be triggered manually via `workflow_dispatch` or the branch trigger needs updating.
+

kingdee_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kingdee_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: kingdee-mcp
+Version: 0.1.0
+Summary: MCP Server for Kingdee Cloud K/3 - Works with any MCP-compatible AI client
+Project-URL: Homepage, https://github.com/WaHaiLong/KingdeeMCP
+Project-URL: Repository, https://github.com/WaHaiLong/KingdeeMCP
+Project-URL: Documentation, https://github.com/WaHaiLong/KingdeeMCP#readme
+Author: WaHaiLong
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,claude,cline,cursor,erp,k3cloud,kingdee,mcp,windsurf
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+# Kingdee MCP Server —— 让 AI 直接操作金蝶云星空 ERP
+
+[![PyPI version](https://img.shields.io/pypi/v/kingdee-mcp?style=flat-square&color=2563eb)](https://pypi.org/project/kingdee-mcp/)
+[![Downloads](https://img.shields.io/pypi/dm/kingdee-mcp?style=flat-square&color=10b981)](https://pypi.org/project/kingdee-mcp/)
+[![Python versions](https://img.shields.io/pypi/pyversions/kingdee-mcp?style=flat-square)](https://pypi.org/project/kingdee-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+
+**Kingdee MCP Server** 是金蝶云星空（Kingdee Cloud Star）ERP 的 [MCP（Model Context Protocol）](https://modelcontextprotocol.io/) 服务端，让 Claude、Cursor、Windsurf、Cline 等 AI 助手能够通过自然语言直接操作金蝶 ERP 系统。
+
+官方网站：https://wahailong.github.io/KingdeeMCP/
+
+## 为什么需要金蝶 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
+```
+
+或使用 uvx 直接运行（推荐，无需手动安装）：
+
+```bash
+uvx kingdee-mcp
+```
+
+## 配置教程
+
+### 第一步：金蝶云星空后台授权
+
+1. 进入 **系统管理 → 第三方系统登录授权 → 新增**
+2. 新建一个集成用户（**不要用 Administrator**）
+3. 生成 **AppID** 和 **AppSecret**
+4. 为该用户分配所需模块的操作权限
+
+### 第二步：配置 MCP 客户端
+
+在你的 MCP 客户端配置文件中添加以下内容：
+
+```json
+{
+  "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 文档](https://docs.openclaw.ai/) |
+
+### 第三步：重启客户端
+
+配置完成后重启你的 MCP 客户端即可开始使用。
+
+## 环境变量说明
+
+| 变量 | 说明 | 示例 |
+|------|------|------|
+| `KINGDEE_SERVER_URL` | 金蝶私有云服务器地址（需包含 /k3cloud/） | `http://192.168.1.100/k3cloud/` |
+| `KINGDEE_ACCT_ID` | 账套ID | `69ae8ed35dab20` |
+| `KINGDEE_USERNAME` | 集成用户名 | `API集成` |
+| `KINGDEE_APP_ID` | 应用ID | `338898_xxxxx` |
+| `KINGDEE_APP_SEC` | 应用密钥（AppSecret） | `f8b75d4ccxxxx` |
+
+## 可用工具列表
+
+### 元数据查询
+
+| 工具名称 | 功能说明 |
+|----------|---------|
+| `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
+反审核销售订单 SO2024001
+```
+
+## 支持的单据类型（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: 支持金蝶云星空公有云吗？**
+目前主要针对私有云测试，公有云用户可能需要调整认证方式。
+
+**Q: 如何添加自定义工具？**
+基于 FastMCP 框架，在 `server.py` 中添加 `@mcp.tool()` 装饰器方法即可扩展。
+
+## 相关链接
+
+- [官方网站](https://wahailong.github.io/KingdeeMCP/)
+- [PyPI 包页面](https://pypi.org/project/kingdee-mcp/)
+- [MCP 协议文档](https://modelcontextprotocol.io/)
+- [金蝶云星空官网](https://www.kingdee.com/)
+
+## License
+
+MIT © WaHaiLong

kingdee_mcp-0.1.0/README.md

@@ -0,0 +1,201 @@
+# Kingdee MCP Server —— 让 AI 直接操作金蝶云星空 ERP
+
+[![PyPI version](https://img.shields.io/pypi/v/kingdee-mcp?style=flat-square&color=2563eb)](https://pypi.org/project/kingdee-mcp/)
+[![Downloads](https://img.shields.io/pypi/dm/kingdee-mcp?style=flat-square&color=10b981)](https://pypi.org/project/kingdee-mcp/)
+[![Python versions](https://img.shields.io/pypi/pyversions/kingdee-mcp?style=flat-square)](https://pypi.org/project/kingdee-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)
+
+**Kingdee MCP Server** 是金蝶云星空（Kingdee Cloud Star）ERP 的 [MCP（Model Context Protocol）](https://modelcontextprotocol.io/) 服务端，让 Claude、Cursor、Windsurf、Cline 等 AI 助手能够通过自然语言直接操作金蝶 ERP 系统。
+
+官方网站：https://wahailong.github.io/KingdeeMCP/
+
+## 为什么需要金蝶 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
+```
+
+或使用 uvx 直接运行（推荐，无需手动安装）：
+
+```bash
+uvx kingdee-mcp
+```
+
+## 配置教程
+
+### 第一步：金蝶云星空后台授权
+
+1. 进入 **系统管理 → 第三方系统登录授权 → 新增**
+2. 新建一个集成用户（**不要用 Administrator**）
+3. 生成 **AppID** 和 **AppSecret**
+4. 为该用户分配所需模块的操作权限
+
+### 第二步：配置 MCP 客户端
+
+在你的 MCP 客户端配置文件中添加以下内容：
+
+```json
+{
+  "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 文档](https://docs.openclaw.ai/) |
+
+### 第三步：重启客户端
+
+配置完成后重启你的 MCP 客户端即可开始使用。
+
+## 环境变量说明
+
+| 变量 | 说明 | 示例 |
+|------|------|------|
+| `KINGDEE_SERVER_URL` | 金蝶私有云服务器地址（需包含 /k3cloud/） | `http://192.168.1.100/k3cloud/` |
+| `KINGDEE_ACCT_ID` | 账套ID | `69ae8ed35dab20` |
+| `KINGDEE_USERNAME` | 集成用户名 | `API集成` |
+| `KINGDEE_APP_ID` | 应用ID | `338898_xxxxx` |
+| `KINGDEE_APP_SEC` | 应用密钥（AppSecret） | `f8b75d4ccxxxx` |
+
+## 可用工具列表
+
+### 元数据查询
+
+| 工具名称 | 功能说明 |
+|----------|---------|
+| `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
+反审核销售订单 SO2024001
+```
+
+## 支持的单据类型（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: 支持金蝶云星空公有云吗？**
+目前主要针对私有云测试，公有云用户可能需要调整认证方式。
+
+**Q: 如何添加自定义工具？**
+基于 FastMCP 框架，在 `server.py` 中添加 `@mcp.tool()` 装饰器方法即可扩展。
+
+## 相关链接
+
+- [官方网站](https://wahailong.github.io/KingdeeMCP/)
+- [PyPI 包页面](https://pypi.org/project/kingdee-mcp/)
+- [MCP 协议文档](https://modelcontextprotocol.io/)
+- [金蝶云星空官网](https://www.kingdee.com/)
+
+## License
+
+MIT © WaHaiLong

kingdee_mcp-0.1.0/docs/googlef357cdebef85fa15.html

@@ -0,0 +1 @@
+google-site-verification: googlef357cdebef85fa15.html