用途:指导开发者构建 MCP 服务器,让 LLM 能通过类型化工具发现并调用外部服务,适用于对接外部 API、向智能体暴露本地文件/数据库/服务能力等场景。
主要能力:提供四阶段开发工作流。阶段一调研规划,要求研读 MCP 协议文档(https://modelcontextprotocol.io/sitemap.xml),分析目标 API 的读写操作、认证、限流与分页,设计工具覆盖范围并选择传输方式(远程用 Streamable HTTP,本地默认 stdio)。阶段二实现,推荐 TypeScript(@modelcontextprotocol/sdk)或 Python(FastMCP),给出项目结构、Zod/Pydantic 输入校验、响应格式、共享工具(API 客户端、错误处理、分页)与错误处理模式。阶段三评审测试,含代码评审清单、构建验证命令(npm run build、npx tsc --noEmit、python -m py_compile、mypy)及 MCP Inspector 测试。阶段四为每个服务器设计 10 个独立评估问题。
关键约束:每个工具必须声明 readOnlyHint、destructiveHint、idempotentHint、openWorldHint 四个意图注解;工具名用 snake_case 动词-名词;输入需带 describe() 描述;避免过宽工具、泄露令牌、缺少分页等常见陷阱。
参考模板:文档列出 PostgreSQL、SQLite、Filesystem、GitHub 官方服务器及安装命令,如 npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb、npx -y @modelcontextprotocol/server-sqlite /path/to/database.db、npx -y @modelcontextprotocol/server-filesystem /allowed/path、npx -y @modelcontextprotocol/server-github(需 GITHUB_PERSONAL_ACCESS_TOKEN)。
限制:文档未提供具体收费、价格或效果数据;部分内容(如跨 IDE 智能体检测的配置路径)以示例形式给出,实际使用需以官方文档为准。