MCP Builder Skill

概述

MCP Builder Skill 是 Anthropic 官方发布的 Claude Skills 之一,旨在指导创建高质量的 MCP (Model Context Protocol) 服务器,使 LLM 能够通过精心设计的工具与外部服务交互。这个全面的 Skill 提供了一个完整的框架,用于使用 Python(使用 FastMCP)或 Node/TypeScript(使用 MCP SDK)构建 MCP 服务器。

该 Skill 包含广泛的文档、最佳实践以及一个结构化的四阶段开发过程,涵盖从研究和规划到实施、测试和评估创建的所有内容。MCP 服务器的质量通过它使 LLM 完成实际任务的能力来衡量。

核心功能

1. 现代 MCP 设计原则

全面指导:

• API 覆盖 vs. 工作流工具: 平衡全面的端点与专业化工作流程
• 工具命名和可发现性: 使用一致前缀的清晰、描述性命名
• 上下文管理: 简洁的描述和专注、相关的数据
• 可操作的错误消息: 提供具体建议的解决方案指导

2. 四阶段开发过程

阶段 1: 深入研究和规划

• 理解现代 MCP 设计模式
• 学习 MCP 协议文档
• 学习特定于框架的模式
• 规划实施策略

阶段 2: 实施

• 项目结构设置
• 核心基础设施(API 客户端、错误处理、分页)
• 使用适当模式实现工具
• 支持输出模式和结构化内容

阶段 3: 审查和测试

• 代码质量审查(DRY、错误处理、类型)
• 构建验证
• 使用 MCP Inspector 测试
• 特定于语言的质量检查

阶段 4: 创建评估

• 10 个复杂、真实的评估问题
• 只读、可验证的测试用例
• 用于自动化测试的 XML 格式

3. 全面的文档库

包括访问:

• MCP 协议规范: 完整的协议文档
• 最佳实践指南: 通用 MCP 指南
• Python 指南: 完整的 FastMCP 实现模式
• TypeScript 指南: 完整的 MCP SDK 实现模式
• 评估指南: 创建有效的测试用例

4. 工具实现最佳实践

创建工具的指导,包括:

• 输入模式: 使用 Zod (TypeScript) 或 Pydantic (Python)
• 输出模式: 用于客户端处理的结构化数据定义
• 描述: 带有参数文档的简洁摘要
• 注释: readOnlyHint、destructiveHint、idempotentHint、openWorldHint
• 错误处理: 带有具体指导的可操作消息

5. 框架支持

完全支持两个生态系统:

• TypeScript: 使用 streamable HTTP 或 stdio 传输的 MCP SDK
• Python: 使用 streamable HTTP 或 stdio 传输的 FastMCP

使用场景

• API 集成: 将 LLM 连接到外部服务(GitHub、Slack、数据库)
• 自定义工具: 为内部系统构建专业化工具
• 数据访问: 使 LLM 能够查询和检索外部数据
• 服务编排: 协调多个外部服务
• 工作流自动化: 为常见任务创建高级工作流工具

技术实现

推荐技术栈

• 语言: TypeScript(推荐用于兼容性和 AI 代码生成)
• 传输: 远程服务器使用 Streamable HTTP,本地服务器使用 stdio
• 无状态 JSON: 更易于扩展和维护

Python 实现

• 框架: Python SDK / FastMCP
• 模式验证: Pydantic 模型
• 工具注册: @mcp.tool 装饰器
• 错误处理: Python 异常模式

TypeScript 实现

• 框架: MCP SDK
• 模式验证: Zod 模式
• 工具注册: server.registerTool
• 结构化内容: 用于丰富响应的现代 SDK 功能

开发工作流程

1. 研究阶段: 学习 MCP 文档、框架文档和 API 文档
2. 规划阶段: 选择要实现的工具,设计模式
3. 实施阶段: 构建服务器基础设施和工具
4. 测试阶段: 使用 MCP Inspector 验证,检查质量
5. 评估阶段: 创建 10 个真实的测试问题

质量标准

该 Skill 确保服务器满足高质量标准:

• 无重复代码(DRY 原则)
• 一致的错误处理
• 完整的类型覆盖
• 清晰、简洁的工具描述
• 全面的 API 覆盖
• 可操作的错误消息
• 正确的注释

评估创建

包括创建有效评估的详细指南:

• 10 个复杂的、多步骤的问题
• 仅只读操作
• 独立、可验证的答案
• 随时间稳定
• 基于真实用例
• 用于自动化的 XML 格式

参考文档

该 Skill 提供访问:

• MCP 协议规范(来自 modelcontextprotocol.io)
• MCP 最佳实践 (mcpbestpractices.md)
• TypeScript 实现指南 (nodemcpserver.md)
• Python 实现指南 (pythonmcpserver.md)
• 评估指南 (evaluation.md)

总结

MCP Builder Skill 是创建高质量 MCP 服务器的权威指南,使 LLM 能够有效地与外部服务交互。通过全面的文档、结构化流程以及 Python 和 TypeScript 实现的最佳实践,此 Skill 确保 MCP 服务器设计良好、经过彻底测试,并使 LLM 能够高效地完成实际任务。