New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Kingdee MCP Dev

by WaHaiLong in WaHaiLong/KingdeeMCP

Knowledge base for the Kingdee MCP Dev Squad. An agent skill from WaHaiLong/KingdeeMCP.

MITAuto-check passedBackend & APIs

Install Kingdee MCP Dev

skills CLI
$ npx skills add WaHaiLong/KingdeeMCP --skill kingdee-mcp-dev -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install WaHaiLong/KingdeeMCP kingdee-mcp-dev --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/WaHaiLong/KingdeeMCP.git skills-src && mkdir -p .claude/skills && cp -r skills-src/expert/kingdee-mcp-dev/skills/kingdee-mcp-dev .claude/skills/kingdee-mcp-dev && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kingdee-mcp-dev
GitHub stars
105
Token cost
~853 tokens
SKILL.md length
222 words
Files
7 (incl. references)
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Knowledge base for the Kingdee MCP Dev Squad. An agent skill from WaHaiLong/KingdeeMCP.

  • Tasks that involve MCP servers
  • SKILL.md covers 项目事实（已实证，勿凭记忆）, ApiDoc 结构（浏览器实测）, 集成工作流（团队 SOP 映射） and 提速工具（已落地 server.py，优先复用）, plus 2 more sections
  • Calls python; reaches openapi.open.kingdee.com; needs KINGDEE_PASSWORD
  • Tasks that involve Operations and SOPs

What it does

Kingdee MCP Dev is an agent skill from WaHaiLong/KingdeeMCP. Knowledge base for the Kingdee MCP Dev Squad. Covers how to integrate the Kingdee Cloud Star OpenAPI (ApiDoc) interfaces into the kingdee-mcp Python+FastMCP project: WebAPI login/metadata caching, field-discovery SOP, 二开 (customized) bill pitfalls, and the ApiDoc coverage tracking template.

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/api-inventory-raw.json`, `references/apidoc-coverage-template.md` and `references/avoid-duplication.md`).

It sits in Backend & APIs, covering MCP servers, Operations and SOPs and OpenAPI specifications. It works with Model Context Protocol, Python and OpenAPI. The repository describes itself as: 金蝶云星空 MCP Server：让 Claude/Cursor 等 AI 助手用自然语言直接查询、操作 ERP（采购/销售/库存/财务等 97 个工具）. The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers
  • Tasks that involve Operations and SOPs
  • Tasks that involve OpenAPI specifications

Example prompts

  • “/kingdee-mcp-dev”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 2c44e6f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • openapi.open.kingdee.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • KINGDEE_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kingdee MCP Dev loads about 853 tokens when it runs, and up to ~202k if it reads all its reference files. Until then it costs about 77 tokens; SKILL.md has 222 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~853
With references · SKILL.md plus every file in references/, read only if the agent opens them
~202k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from WaHaiLong/KingdeeMCP at commit 2c44e6f, republished under its MIT licence (© WaHaiLong). 222 words, ~853 tokens.

Download SKILL.mdSave it as .claude/skills/kingdee-mcp-dev/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
kingdee-mcp-dev
description
Knowledge base for the Kingdee MCP Dev Squad. Covers how to integrate the Kingdee Cloud Star OpenAPI (ApiDoc) interfaces into the kingdee-mcp Python+FastMCP project: WebAPI login/metadata caching, field-discovery SOP, 二开 (customized) bill pitfalls, and the ApiDoc coverage tracking template.
metadata.version
1.0.0

金蝶 MCP 开发团 · 知识库

本 Skill 是 kingdee-mcp-dev 专家团的共享知识底座，供主理人（龚联达）与四位团员（范探源 / 寇豆码 / 严过关 / 温书成）在协作时查阅。目标是把金蝶开放平台 ApiDoc 的全部接口集成进 D:\AI\projects\kingdee-mcp。

项目事实（已实证，勿凭记忆）

  • 源码位置：D:\AI\projects\kingdee-mcp，Python + FastMCP。
  • 工具规模：src/kingdee_mcp/server.py 当前 97 个 @mcp.tool（2026-08-07 实测 97；本日新增 6 个标准动作通用工具 kingdee_cancel_bills / kingdee_void_bills / kingdee_close_bill / kingdee_unclose_bill / kingdee_forbid_bills / kingdee_enable_bills，覆盖 14/15 标准动作；报表由 kingdee_query_report 覆盖；覆盖 13 大业务域 + 4 个 SQL Server 探查）。
  • 构建后端：hatchling（python -m build），dist/ 产物 kingdee_mcp-0.2.0-py3-none-any.whl / .tar.gz。
  • 运行环境：金蝶 K3Cloud http://<K3Cloud-Server>/k3cloud/，账套 <ACCT_ID>（<公司名>）。
  • 登录方式：仅账号密码（ValidateUser），无第三方应用授权；配置 KINGDEE_SERVER_URL / KINGDEE_ACCT_ID / KINGDEE_USERNAME / KINGDEE_PASSWORD。
  • WebAPI 权限拒绝返回 [[{'Result':{报错}}]]（r[0][0] 是 dict），正常数据返回 [[值,...]]（r[0][0] 是标量）—— 写查询脚本务必用此区分，否则会把错误当数据。

ApiDoc 结构（浏览器实测）

https://openapi.open.kingdee.com/ApiDoc 是 Element UI(el-tree) SPA，需真实浏览器爬取。结构为 16 业务领域 → 77 模块 → 操作（标准金蝶 WebAPI 动作集）：

  • 16 业务领域：员工服务、财务会计、税务管理、成本管理、资产管理、管理会计、供应链、电商与分销、零售管理、生产制造、质量管理、星空云服务、基础管理、BOS、移动应用、PLM。
  • 标准操作动作（每个单据模块通用）：保存 / 提交 / 审核 / 反审核 / 撤销 / 下推 / 作废 / 整单关闭 / 反关闭 / 批量保存 / 单据查询 / 查看 / 暂存 / 删除，外加部分领域专属动作（如费用类「申请单退款」）。
  • 原始抓取树见 references/api-inventory-raw.json（领域→模块已全量；操作级仅在「员工服务」域完整抓取，其余域操作需逐模块切换抓取）。

集成工作流（团队 SOP 映射）

阶段负责团员关键动作输入 → 输出
探字段 / WebAPI 映射范探源kingdee_get_fields 探 FormId 与字段 Key；映射 ApiDoc 操作到 Save/Submit/Audit/Push/ExecuteBillQuery任务 → 字段/操作映射表
实现 @mcp.tool寇豆码复用提速工具，落地工具代码映射表 → 工具签名
测试回归严过关bin/kmcp test + 用例；区分权限拒绝 vs 正常数据工具签名 → 回归报告
文档 / 发布温书成更新 docs/、mcp_optimization_notes.md、CHANGELOG；bin/kmcp build → twine upload → Pages变更 → 发布清单

提速工具（已落地 server.py，优先复用）

  • kingdee_validate_bill：保存前校验，返回 auto_fixes / missing_required / entry_issues / suggestions，不真正保存。
  • kingdee_get_bill_template：取已验证 model 骨架，支持 SAL_Quotation / SAL_SaleOrder / PUR_PurchaseOrder。
  • kingdee_refresh_metadata：强制刷新元数据。
  • 元数据已落盘缓存到 ~/.workbuddy/kingdee_metadata_cache/。

推荐工作流：get_bill_template → 填数 → validate_bill → save_bill。

必读参考

  • references/webapi-login-cache.md — 金蝶 WebAPI 登录机制、元数据缓存读取与刷新。
  • references/field-discovery-sop.md — kingdee_get_fields 探字段的标准操作流程与返回解析。
  • references/ercustom-pitfalls.md — 本环境二开单据坑（SAL_SaleOrder 二开、TRNV_Receipt/PaymentSlip、FCUSTID 全大写、FBaseUnitId 等）。
  • references/apidoc-coverage-template.md — ApiDoc 覆盖进度跟踪表模板，配合 bin/kmcp coverage 使用。
  • references/avoid-duplication.md — 防止重复开发红线：通用/专用工具清单 + 决策树 + bin/kmcp tools 查重用法。开工前必读。

助手命令（bin/kmcp）

团队配套 CLI bin/kmcp：

  • bin/kmcp test — 跑 evals/ + tests/ 回归（连真实金蝶环境）。
  • bin/kmcp build — python -m build 构建 wheel / sdist。
  • bin/kmcp list-tools — 统计 @mcp.tool 数量。
  • bin/kmcp coverage — 对照 references/api-inventory-raw.json 输出 ApiDoc 覆盖进度。

© WaHaiLong, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in expert/kingdee-mcp-dev/skills/kingdee-mcp-dev of WaHaiLong/KingdeeMCP.

  • SKILL.md
  • references/api-inventory-raw.json
  • references/apidoc-coverage-template.md
  • references/avoid-duplication.md
  • references/ercustom-pitfalls.md
  • references/field-discovery-sop.md
  • references/webapi-login-cache.md

Open the folder on GitHubat commit 2c44e6f

Compare with similar skills

Kingdee MCP Dev next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kingdee MCP Dev compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kingdee MCP Dev this skillWaHaiLong/KingdeeMCP105—~853Automated safety check: PassMIT
MCP Server Builderalirezarezvani/claude-skills28k—~985Automated safety check: PassMIT
Azure Aigatewaymicrosoft/GitHub-Copilot-for-Azure2551 repos~1.3kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
API Endpoint Contracttrycompai/comp2k—~2.7kAutomated safety check: PassAGPL-3.0
SpikardGoldziher/spikard124—~799Automated safety check: PassMIT

Similar skills

  • MCP Server Builder

    alirezarezvani/claude-skills

    Design and ship production-ready MCP (Model Context Protocol) servers from OpenAPI contracts instead of hand-written tool wrappers.

    28k GitHub stars~985 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

  • Azure Aigateway

    microsoft/GitHub-Copilot-for-Azure

    Official

    Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents.

    255 GitHub starsUsed in 1 repo~1.3k tokens
    Backend & APIsAuto-check passed

  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • API Endpoint Contract

    trycompai/comp

    The contract every new or modified API endpoint must follow so it is correct for the public OpenAPI spec, the MCP server (npm @trycompai/mcp-server), the ValidationPipe, and the docs.

    2k GitHub stars~2.7k tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Spikard

    Goldziher/spikard

    Scaffold Spikard projects and generate code from OpenAPI, AsyncAPI, OpenRPC, GraphQL, and Protobuf schemas using the Spikard CLI or its MCP server.

    124 GitHub stars~799 tokensUpdated yesterday
    Backend & APIsAuto-check passed

  • Frontmcp Development

    agentfront/frontmcp

    A skill your agent uses when building any FrontMCP server component other than a tool (for tools, use create-tool).

    146 GitHub stars~11k tokensUpdated today
    Backend & APIsAuto-check passed

More from WaHaiLong/KingdeeMCP

  • Kingdee Query

    WaHaiLong/KingdeeMCP

    基于已连接的 kingdee-mcp（第三方开源金蝶云星空 MCP 服务器，非金蝶官方出品），用自然语言查询与操作金蝶 ERP：销售/采购订单、即时库存、物料档案、客户/供应商、单据提交/审核/下推、生产/成本/资产等。当用户提到"金蝶""查金蝶""金蝶销售订单/库存/物料"等 ERP 查询或操作需求时触发。

    105 GitHub stars~907 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Kingdee MCP Dev

What does Kingdee MCP Dev do?

Knowledge base for the Kingdee MCP Dev Squad. An agent skill from WaHaiLong/KingdeeMCP. Kingdee MCP Dev is an agent skill from WaHaiLong/KingdeeMCP. Knowledge base for the Kingdee MCP Dev Squad.

When should I use Kingdee MCP Dev?

Kingdee MCP Dev fits situations like: tasks that involve MCP servers; tasks that involve Operations and SOPs; tasks that involve OpenAPI specifications.

How do I install Kingdee MCP Dev in Claude Code?

Run `npx skills add WaHaiLong/KingdeeMCP --skill kingdee-mcp-dev -a claude-code`. Or copy the skill folder (expert/kingdee-mcp-dev/skills/kingdee-mcp-dev in WaHaiLong/KingdeeMCP) into .claude/skills/kingdee-mcp-dev in your project. Claude Code loads it when a task matches its description.

How do I install Kingdee MCP Dev in Codex?

Run `npx skills add WaHaiLong/KingdeeMCP --skill kingdee-mcp-dev -a codex`. Or copy the skill folder (expert/kingdee-mcp-dev/skills/kingdee-mcp-dev in WaHaiLong/KingdeeMCP) into .agents/skills/kingdee-mcp-dev in your project. Codex loads it when a task matches its description.

Can I use Kingdee MCP Dev in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add WaHaiLong/KingdeeMCP --skill kingdee-mcp-dev -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kingdee-mcp-dev, .gemini/skills/kingdee-mcp-dev, .github/skills/kingdee-mcp-dev and .opencode/skills/kingdee-mcp-dev in your project.

What does Kingdee MCP Dev need to run?

Going by SKILL.md and its folder, Kingdee MCP Dev needs the command-line tools its instructions call (python) and credentials named KINGDEE_PASSWORD. Our summary lists: Python 3.

Does Kingdee MCP Dev access the network?

SKILL.md names 1 domain. In commands or code: openapi.open.kingdee.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Kingdee MCP Dev safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kingdee MCP Dev use?

Kingdee MCP Dev is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Kingdee MCP Dev use?

About 853 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 201k tokens, read only when the agent opens those files.

What are the alternatives to Kingdee MCP Dev?

Skills that share tags, products or a category with Kingdee MCP Dev: MCP Server Builder (alirezarezvani/claude-skills, 28k stars), Azure Aigateway (microsoft/GitHub-Copilot-for-Azure, 255 stars), OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars) and API Endpoint Contract (trycompai/comp, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kingdee MCP Dev?

WaHaiLong (a GitHub user) maintains it in WaHaiLong/KingdeeMCP, which has 105 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 11, 2026.

Source: WaHaiLong/KingdeeMCP on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.