MCP Builder Skill

MCP Builder Skill 是什么？

MCP Builder Skill 指导开发者为外部服务创建 Model Context Protocol 服务器，让大模型通过结构清楚的工具、资源和提示访问 API。它覆盖需求研究、工具设计、TypeScript 或 Python 实现、测试以及评估题设计。

开发流程

1. 阅读当前 MCP 规范和目标服务 API，确认认证、数据模型与常用操作。
2. 规划工具范围、命名、输入输出结构、分页和错误信息。
3. 建立 API 客户端、认证、响应格式和通用错误处理。
4. 实现工具并标注只读、破坏性、幂等和开放网络等属性。
5. 编译、使用 MCP Inspector 测试，再通过真实任务评估可用性。

技术选择

说明优先推荐 TypeScript 和官方 MCP SDK，也提供 Python FastMCP 参考。远程服务通常考虑 Streamable HTTP，本地服务可使用 stdio。输入结构可用 Zod 或 Pydantic，输出尽量提供结构化数据，并保留适合模型阅读的文本。

好工具的标准

工具名称要清楚、动作导向并保持一致前缀。描述和字段要帮助模型正确选择工具，返回内容应支持筛选和分页，错误信息需要说明原因与下一步。接口覆盖与高层工作流工具之间需要根据客户端和任务平衡。

限制与安全

MCP 服务器会接触外部账户和数据。认证信息必须安全保存，写操作要明确标注并限制权限，测试阶段优先使用只读操作和隔离环境。规范和 SDK 会更新，开发前应读取当前官方资料。

许可证

该目录中的 LICENSE.txt 当前为 Apache-2.0，使用的 SDK 和第三方 API 另有各自条款。

常见问题 FAQ

1. 支持哪些语言？

主要提供 TypeScript 与 Python 实现指南。

2. 本地服务器用什么传输？

本地集成通常使用 stdio，远程服务常考虑 Streamable HTTP。

3. 工具越多越好吗？

不一定。覆盖面要足够，但命名、描述和返回数据必须便于模型选择。

4. 如何定义输入结构？

TypeScript 可用 Zod，Python 可用 Pydantic，并为字段添加限制和说明。

5. 怎样测试 MCP 服务器？

先编译或检查语法，再使用 MCP Inspector 和真实任务验证。

6. 为什么要写评估题？

评估题可以检查模型是否能组合工具完成真实而复杂的任务。

7. 写操作如何保证安全？

使用最小权限、明确标注破坏性、验证输入，并在测试环境先运行。

8. 能直接照搬旧规范吗？

不建议，MCP 规范和 SDK 可能变化，实施时要读取当前资料。

来源与核验说明

本条目根据 Anthropic 官方 Skills 仓库中的 mcp-builder 开发流程整理。