用途:指导开发者构建 MCP 服务器,使 LLM 能通过设计良好的工具与外部服务交互。
主要能力与流程:
- 研究与规划:理解现代 MCP 设计,平衡完整 API 覆盖与专用工作流工具;使用清晰、带一致前缀的描述性工具名(如 github_create_issue);设计返回聚焦相关数据的工具;提供可操作的错误信息。学习 MCP 协议可从站点地图 https://modelcontextprotocol.io/sitemap.xml 入手,重点页面包括规范、传输机制、工具定义。
- 实现:推荐技术栈为 TypeScript(SDK 支持最佳),传输方式为远程用 Streamable HTTP、本地用 stdio。项目结构示例:my-mcp-server/ 下含 src/index.ts(入口)、src/tools/(工具实现)、src/utils/(共享工具)、package.json、tsconfig.json。工具实现使用 server.registerTool,包含 name、description、inputSchema、outputSchema、annotations(readOnlyHint、destructiveHint、idempotentHint)与 handler。
- 测试:TypeScript 执行 npm run build 与 npx @modelcontextprotocol/inspector;Python 执行 python -m py_compile your_server.py。
- 创建评估:编写 10 个复杂、真实的问题测试服务器,采用 qa_pair 格式记录问题与答案。
工具设计最佳实践:使用 Zod(TS)或 Pydantic(Python)定义 schema;在字段描述中包含约束与示例;为结构化数据定义 outputSchema;在适用处支持分页;添加工具注解(readOnly、destructive、idempotent)。
限制:资料未提供具体收费、价格、平台支持范围或效果数据,暂未提供相关信息。