mcp-builder

mcp-builder 技能是一个全面的开发框架，旨在协助工程师和开发者建立稳健的 Model Context Protocol (MCP) 服务器。通过实现这些服务器，您可以让大型语言模型 (LLM) 与外部服务、API 及专有数据源进行无缝交互。本技能提供结构化的四个开发阶段，涵盖从架构规划、协议研究到实现、测试与评估的完整流程。它强调工具命名、上下文管理与错误处理的最佳实践，确保所生成的 MCP 工具对于 AI 代理而言具有高可发现性与可操作性。

• 简化使用标准 MCP 规范集成外部 API 的过程，支持如 stdio 与 streamable HTTP 等传输机制及正确的身份验证模式。

• 支持 TypeScript (通过 MCP SDK) 与 Python (通过 FastMCP) 开发，提供标准化的项目结构与模块组织。

• 提供设计高效工具结构的指引，使用 Zod 或 Pydantic 进行输入验证，并实现结构化输出架构以提升 LLM 的理解能力。

• 包含提升工具可靠性的技术，例如实现分页、带有可操作建议的清晰错误信息，以及使用 idempotentHint 与 destructiveHint 等注释。

• 提供内置的评估工作流程，协助您生成复杂的测试案例，以验证 MCP 工具在真实场景中的准确性与实用价值。

• 请遵循指定阶段：研究 MCP 规范、规划工具集、实现基础设施（API 客户端、格式化、分页），并建立完整的评估数据集。

• 当不确定时，优先考虑 API 的全面覆盖范围而非仅局限于特定工作流程工具，以赋予代理组合作业的最大灵活性。

• 在部署前，务必使用 MCP Inspector (npx @modelcontextprotocol/inspector 或 Python 对应工具) 测试服务器功能。

• 确保工具描述简洁且具备信息量，以协助代理在执行 LLM 期间进行工具探索与上下文管理。

• 始终严格验证输入与输出；强烈建议返回结构化数据，以支持高级的客户端处理。