SuperAPI AI 工具集

mcp-builder

智能体与模型

查看项目

更新于 10-15 21:48

技能介绍

用途:指导开发者构建高质量 MCP 服务器,使 LLM 能通过设计良好的工具与外部服务交互。官方以“能否帮助 LLM 完成真实任务”作为衡量服务器质量的标准。

主要流程分为四阶段。一、深度研究与规划:理解现代 MCP 设计,权衡 API 全覆盖与工作流专用工具,注意工具命名与可发现性、上下文管理、可操作的错误信息;研读 MCP 协议文档(从 https://modelcontextprotocol.io/sitemap.xml 开始,用 .md 后缀获取 Markdown 页面,如 https://modelcontextprotocol.io/specification/draft.md),并查阅框架文档。推荐技术栈:TypeScript,远程服务器用 Streamable HTTP 无状态 JSON,本地服务器用 stdio。

二、实现:搭建项目结构,编写含认证的 API 客户端、错误处理、响应格式化、分页等共享设施;每个工具用 Zod(TypeScript)或 Pydantic(Python)定义输入 Schema,尽量定义 outputSchema 并在响应中使用 structuredContent(TypeScript SDK 特性),附工具描述与注解(readOnlyHint、destructiveHint、idempotentHint、openWorldHint),I/O 用异步并支持分页。

三、审查与测试:检查无重复代码、错误处理一致、类型覆盖完整、描述清晰;TypeScript 运行 npm run build 验证编译,并用 npx @modelcontextprotocol/inspector 测试;Python 用 python -m py_compile your_server.py 验证语法,再用 MCP Inspector 测试。

四、创建评估:编写 10 个独立、只读、复杂、真实、可验证且答案稳定的问题,最后输出如下结构文件:<evaluation><qa_pair><question>...</question><answer>...</answer></qa_pair></evaluation>。

参考文档:Python SDK https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md;TypeScript SDK https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md。文中还提到中文文档、中文注释与中文 FAQ 等国内适配内容,但具体内容暂未提供。限制:未提供具体收费、价格、平台与效果信息。