mcp-builder

mcp-builder 技能为开发 MCP（模型上下文协议）服务器的开发者提供了一个全面的、结构化的框架。本指南旨在促进 LLM 与外部软件服务之间的无缝集成，涵盖了从初步研究和架构规划到实现、测试和评估的整个开发生命周期。对于希望以标准、高效且可靠的方式将内部工具、数据库或 API 暴露给 AI Agent 的工程师来说，这是一项必不可少的资源。

该技能强调 API 设计的最佳实践，重点在于创建具描述性的工具模式（Tool Schema）和有效的上下文管理。它为使用推荐的 MCP SDK（Python 的 FastMCP 和 Node/TypeScript 的 MCP SDK）进行开发提供了清晰的路径。用户将学习如何组织项目结构、处理身份验证、实现具备错误处理能力的工具，并利用结构化输出模式和注释等现代功能，确保 LLM 与服务器之间的交互达到最优。

• 关于平衡 API 端点覆盖范围与高阶工作流工具的指导，以最大化 Agent 的实用性。

• 使用 Zod 或 Pydantic 定义工具命名、可发现性以及参数约束的最佳策略。

• 核心基础设施的实现代码蓝图，包括 API 客户端模式、错误处理和数据分页。

• 使用 MCP Inspector 对 TypeScript 和 Python 实现进行标准化测试的工作流。

• 严谨的评估方法论，包括创建 10 个复杂的测试问题，以确保 Agent 能够成功地导航并使用您的工具。

• 推荐技术栈：用于强类型开发的 TypeScript，或用于快速原型开发的 Python FastMCP。

• 推荐传输协议：用于远程可扩展性的流式 HTTP，或用于本地开发和集成的 stdio。

• 重点领域包括工具的幂等性、破坏性提示以及只读操作，以确保 Agent 行为的安全性。

• 请务必确保您的工具描述简洁且具备可操作性，因为这直接影响 LLM 发现和使用您服务的能力。

• 始终根据最新的 MCP 规范页面和指南中提供的架构模式来验证您的服务器实现。