Menu
MCP 服务器设计与实现要点：工具边界、命名、分页、错误、传输选型； 建服四阶段流程。参考 reference/ 精简指南。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | mcp |
| description | MCP 服务器设计与实现要点：工具边界、命名、分页、错误、传输选型； 建服四阶段流程。参考 reference/ 精简指南。 |
设计与实现 Model Context Protocol 服务器时用本 skill。密钥与鉴权清单仍走 security。
github_list_repos）；避免缩写堆砌详阅：reference/best-practices.md
readOnlyHint — 只读查询destructiveHint — 删改/不可逆idempotentHint — 重复调用安全openWorldHint — 开放域/外部实体outputSchema / structuredContent，便于客户端解析精简模式见：reference/typescript-patterns.md · reference/python-patterns.md
（完整 SDK 以官方文档为准，勿在母版内嵌整份 upstream README。）
吸收自 anthropics/skills/mcp-builder。
npx @modelcontextprotocol/inspector 或 Cursor：GetMcpTools → 只读 CallMcpTool 冒烟吸收自 anthropics/skills/mcp-builder · 详 reference/evaluation.md。
MCP 好坏看 LLM 能否仅靠工具答真实难题，不是工具数量。
GetMcpTools 清点工具可选 XML 格式见 reference/evaluation.md。upstream evaluation.py 可批跑，非母版必选。
GetMcpTools（按 server / toolName / pattern）取 schema → 再 CallMcpTool；未读 schema 勿盲调needsAuth → 对该 server 调 mcp_auth 一次后再试；勿对未授权 server 反复 auth# 示例：Inspector（按项目 package 调整）
npx @modelcontextprotocol/inspector
或在 Cursor 中：GetMcpTools → 对目标 tool 做一次只读 CallMcpTool。
| 关切 | 去向 |
|---|---|
| 密钥 · auth · 注入 | security · security-sdlc.mdc |
| 大批量 ID / IN 查询 | rules/execution/data-batch.mdc |
| 组织 MCP 治理（Runlayer 等） | 用户/插件规则；本 skill 不替代治理策略 |
| 文件 | 用途 |
|---|---|
reference/best-practices.md | 命名 · 分页 · 传输 · 错误 |
reference/typescript-patterns.md | TS 最小骨架 |
reference/python-patterns.md | FastMCP 最小骨架 |
reference/evaluation.md | 10 题 eval 门禁 · XML 格式 |
REST/OpenAPI 设计审查。
系统调试循环（/debug）— 复现→假设→隔离→验证→记录；禁止无复现盲改。说「修 bug」「测挂了」「不知道为啥挂」时用。
交付验收（/delivery）：视觉 · i18n · 文档对齐 · 后端对接 · 组件完整度 · 可维护性 · 生产就绪。Sprint 收尾或 /release 分支前走查。说「交付验收」「上线前检查」「生产就绪」时用。
磁盘快照（/disk）：结构化采集 HOME 与可配置路径占用，写入 .cursorGrowth/disk-snapshots/， 并与上次快照对比变动。说「磁盘快照」「空间变动」「disk snapshot」时也触发。
Git — 分支、提交、合并。需要 git 操作时用。
信息架构（IA）规划与审查（/ia）— 工作流正交、角色入口、分支点、反模式。说「信息架构」「导航迷路」「角色首页」「工作流分支」「Dashboard 太乱」时用。