mcp-server-dev (MCP 开发)
Anthropic 官方 MCP 开发技能族:入口技能 build-mcp-server 用决策矩阵先澄清需求再推荐部署形态(remote HTTP/MCP app/MCPB/stdio),配 build-mcp-app(聊天内 UI 组件)与 build-mcpb(本地打包分发),端到端交付能过 Directory 审核的 MCP 服务器。
仓库:anthropics/claude-plugins-official
热度证据:官方插件目录 33,473 star,Anthropic 官方维护的高质量插件之一
五维评分
热度5/5
质量5/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- 先发现后编码的硬性门禁:SKILL.md 明确 'Your first job is discovery, not code',Phase 1 五组需求问题全部用 if-then 决策表映射,附 8 行决策矩阵速查,选错形态(重写级成本)在写代码前就被排除
- 技能链分层 + 一句话交接协议:入口技能只做决策,UI 场景交 build-mcp-app、本地分发交 build-mcpb,交接时用一段话 restate 设计概要,下游技能不重复询问
- 坑点档案化:iframe-sandbox.md 把隐性知识写成症状→根因→修复查表(CSP 空白 iframe、bundle 内联 $ 转义陷阱、dark 主题图片消失、宿主资源缓存),全是主控制台静默、只在 iframe devtools 可见的难调试坑
- 新能力(elicitation)采用能力探测+强制回退:先查 clientCapabilities 再 elicitInput,不支持则文本转述回退,TS 与 FastMCP 双语言 canonical pattern,并区分 decline/cancel 三态响应
- 安全作为一等公民:MCPB 无沙箱背景下给出威胁模型(prompt-injection 可驱动工具调用)、safeJoin 路径包含检查、execFile 数组参数、读写拆分、对抗性测试清单,直接对齐 Anthropic Directory 提审要求
可复用的设计模式
- 决策路由技能模式:入口技能不写代码,用多张 if-then 决策表把专家经验固化为确定性路由,对默认推荐显式表态(Remote HTTP ⭐)
- 能力探测 + 优雅回退模式:依赖宿主新能力的代码先探测 clientCapabilities 再使用,不支持走降级路径并说明未来演进
- 坑点档案 reference:把调试成本最高的隐性知识整理成症状→根因→修复三列表格,附定位线索
- 版本敏感声明账本:versions.md 登记会过期的声明并写明核验方法,文档自认会腐化
适用场景
包一个云 API(SaaS/REST/GraphQL)为 Claude 可用的 MCP 远程服务器给 MCP 工具加聊天内交互 UI(选择器、确认框、图表、实时进度)打包本地 MCP 服务器为 .mcpb 分发给无需 Node/Python 的用户MCP 工具设计:一动作一工具 vs search+execute 大面路由与 schema 打磨作为构建能过 Anthropic Directory 审核的 MCP 集成的完整流程指南
边界与注意:内容体量大、信息密度高,适合按路径按需取用而非通读;部分内容绑定 Anthropic 生态与 2025-2026 spec 版本(elicitation 依赖 Claude Code ≥2.1.76,宿主覆盖仍在推进);widget 部分要求前端与 CSP 知识;MCPB 无平台沙箱,安全完全自担,纯 API 包装场景不应付打包税。
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/cpo-mcp-server-dev.md