用途:该技能是处理大于一行代码规模的 MCP 服务器工作的入口,可优化、审计、加固、复审已有服务器,或在写第一行代码前规划全新服务器。两种模式共用同一参考库(决策树与模式文件各一目录),只需学一次路由。
两种模式: 模式 A(优化已有服务器):节奏为探索→诊断→呈现→优化,不直接写代码。先读仓库,查找 MCP 入口、工具注册、schema、错误处理与传输配置;若找不到 MCP 相关代码则停止并说明缺失前提,不凭空造服务器。随后用引用具体文件与行号的 2–3 个问题诊断;若用户无法追问,转为草稿模式,列出按优先级排序的发现并标注假设,不应用任何改动。发现逐条呈现,关联真实代码证据,引用文档中的阈值(工具数、参数数、延迟)只作诊断线索而非结论。按严重程度处理,得到明确批准后才应用,展示 diff、解释改动并建议验证步骤(通常为 MCP Inspector 或 test-by-mcpc-cli 命令)。 模式 B(从零架构):不写代码,先用 brainstorming-new-mcp.md 的 12 个问题访谈(终端用户任务、本地还是远程、鉴权、有无状态、目标客户端、预期工具数、破坏性操作、分发计划、高级协议需求、成功指标等),产出简短架构草图,取得批准后交接给配套技能,并对照 design-phase.md 做设计期检查。若发现 MCP 并非合适原语(CLI、Claude skill 或 bash 脚本即可),路由到 mcp-vs-cli.md 并停止。
子代理调度:可将当前规范、厂商定价、平台怪癖或 CVE 问题交给 internet-researcher,多文件编辑或脚手架交给 general-purpose,3 个以上竞争性架构方案交给 Plan。任务书需自包含、给出可观察终态与二元 DoD,不写逐步流程;单轮读写可完成的工作不要派发。
配套技能(实际构建或测试服务器,本技能只决定做什么与为什么)及安装命令: npx -y skills add -y -g yigitkonur/skills-by-yigitkonur/skills/<skill-name> 可选:build-mcp-use-server(新 HTTP 优先 TypeScript 服务器,用 mcp-use 封装处理传输、CORS、OAuth、会话,代价是绑定其导入与约定、控制更少)、build-mcp-sdk(规范路径 @modelcontextprotocol/sdk v1.x、单包、Zod v3、客户端兼容最广、stdio 或 HTTP,需手动接传输与 OAuth)、build-mcp-sdk-v2(仅限接受 beta 的全新项目,v2 拆包 @modelcontextprotocol/server、Zod v4、仅 ESM、Node 20+,社区采用尚早,服务端 OAuth 移除、无 CJS)、test-by-mcpc-cli(服务器运行后常用,基于 CLI 的 stdio 或 Streamable HTTP 实时测试,需要本地 mcpc 0.2.x)。
决策树覆盖议题:新服务器、是否该用 MCP、工具接口质量、schema 与错误可靠性、安全与身份(含 2025-11-25 OAuth 2.1、CIMD、OBO)、上下文与成本(含 prompt caching 与渐进式发现)、协议深度(sampling、elicitation、roots、progress、取消、_meta)、客户端与模型兼容、架构与扩展、运维测试部署、分发与信任。快速参考卡按“想做的事”指向对应参考文件;常见陷阱包括把每个 REST 端点包成工具、schema 过度嵌套、返回原始 API JSON、用协议错误表示工具失败、无输入校验、一次注册 30+ 工具、描述含糊、上线前无测试、新远程部署用 SSE、忽略会话清理、每轮破坏 prompt 缓存、假设所有客户端支持 sampling/elicitation、把用户 token 透传给上游 API、发布到官方注册表 v0、未统计冷启动与会话需求就选平台。
限制:具体参考文件内容、安装细节与验证步骤均需按技能仓库实际文件执行;环境未安装配套技能时需先运行上述安装命令。相关收费、价格与效果资料暂未提供。