SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场mcp-builder

mcp-builder

智能体与模型

查看项目

更新于 10-15 20:21

技能介绍

用途

mcp-builder 是一个指导开发者创建高质量 MCP（Model Context Protocol）服务器的技能。MCP 服务器提供工具，使 LLM 能够访问外部服务和 API。该技能的核心目标是：让 LLM 能够借助所提供的工具完成真实世界的任务，并以这一标准衡量 MCP 服务器的质量。

主要能力

该技能围绕四个阶段组织开发流程：

阶段一：深度研究与规划

  • 理解以智能体为中心的设计原则：为工作流而非仅 API 端点构建工具；整合相关操作（例如同时检查可用性并创建事件的 schedule_event）；优化有限的上下文窗口，返回高信号信息而非详尽数据转储，提供“简洁”与“详细”两种响应格式选项，默认使用人类可读标识符而非技术代码；设计可操作的错误信息，引导智能体正确使用；遵循自然任务划分，用一致前缀分组相关工具；采用评估驱动开发。
  • 研究 MCP 协议文档（通过 WebFetch 加载 https://modelcontextprotocol.io/llms-full.txt）。
  • 研究框架文档：MCP 最佳实践；Python 实现需加载 Python SDK 文档（https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md）和 Python 实现指南；Node/TypeScript 实现需加载 TypeScript SDK 文档（https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md）和 TypeScript 实现指南。
  • 详尽研究 API 文档：官方 API 参考、认证与授权要求、速率限制与分页模式、错误响应与状态码、可用端点及参数、数据模型与模式。
  • 创建全面的实现计划，包括工具选择、共享工具与辅助函数、输入/输出设计（Pydantic 或 Zod 验证模型、一致的响应格式、字符限制与截断策略，例如 25,000 tokens）、错误处理策略。

阶段二：实现

  • 设置项目结构：Python 使用单个 .py 文件或模块化组织，使用 MCP Python SDK 注册工具，定义 Pydantic 模型；Node/TypeScript 设置 package.json 和 tsconfig.json，使用 MCP TypeScript SDK，定义 Zod 模式。
  • 先实现核心基础设施：API 请求辅助函数、错误处理工具、响应格式化函数（JSON 和 Markdown）、分页辅助、认证/令牌管理。
  • 系统化实现工具：定义输入模式（含约束和清晰字段描述）、编写全面的文档字符串/描述、实现工具逻辑（异步 I/O、错误处理、多响应格式、分页、字符限制）、添加工具注解（readOnlyHint、destructiveHint、idempotentHint、openWorldHint）。
  • 遵循语言特定最佳实践：Python 使用 MCP Python SDK、Pydantic v2 模型、类型提示、async/await、模块级常量；Node/TypeScript 正确使用 server.registerTool、Zod 模式加 .strict()、严格模式、无 any 类型、显式 Promise 返回类型、配置构建过程。

阶段三：审查与优化

  • 代码质量审查：DRY 原则、可组合性、一致性、错误处理、类型安全、文档。
  • 测试与构建：MCP 服务器是长时间运行的进程，直接在主进程中运行会导致挂起。安全测试方式包括使用评估工具、在 tmux 中运行、使用超时（如 timeout 5s python server.py）。Python 可验证语法 python -m py_compile your_server.py；Node/TypeScript 运行 npm run build 并确认 dist/index.js 生成。
  • 使用质量检查清单。

阶段四：创建评估

  • 创建 10 个评估问题，要求每个问题独立、只读、复杂、真实、可验证、稳定。
  • 输出为 XML 格式，包含 question 和 answer 的 qa_pair 结构。

使用方式

该技能通过加载参考文档并遵循四阶段流程来使用。开发过程中按需加载：核心 MCP 文档（MCP 协议、MCP 最佳实践）、SDK 文档（Python SDK、TypeScript SDK）、语言特定实现指南（Python 实现指南、TypeScript 实现指南）、评估指南。

适用场景

适用于需要创建 MCP 服务器、让 LLM 与外部服务或 API 交互的开发场景，支持 Python 和 Node/TypeScript 两种技术栈。

限制

资料未提供该技能的具体安装命令、收费信息、平台限制或效果保证。