SuperAPI AI 工具集

mcp-builder

智能体与模型

查看项目

更新于 10-16 03:47

技能介绍

用途:mcp-builder 是一份指导创建高质量 MCP(Model Context Protocol)服务器的技能文档。MCP 服务器提供工具,让 LLM 能访问外部服务与 API;其质量以能否帮助 LLM 完成真实任务来衡量。

主要能力:给出四阶段开发流程。阶段一为深度调研与规划,包括面向智能体的设计原则(按工作流而非仅 API 端点设计工具、为有限上下文优化、设计可操作的错误信息、遵循自然任务拆分、评估驱动开发),并需研读 MCP 协议文档、框架文档与 API 文档,产出实施计划(工具选择、共享工具、输入输出设计、错误处理策略)。阶段二为实现,先搭项目结构,再实现核心基础设施,最后系统化实现工具,包括输入校验模型(Python 用 Pydantic,TypeScript 用 Zod)、文档字符串、工具注解(readOnlyHint、destructiveHint、idempotentHint、openWorldHint)及语言特定规范。阶段三为审查与细化,涉及代码质量检查与构建测试。阶段四为创建评估,要求编写 10 道独立、只读、复杂、真实、可验证且稳定的题目,并以 XML 格式输出。

使用方式:按阶段推进,按需加载参考文件。可获取 MCP 协议文档:https://modelcontextprotocol.io/llms-full.txt;Python SDK:https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md;TypeScript SDK:https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md。Python 可用 python -m py_compile your_server.py 校验语法;Node/TypeScript 用 npm run build。注意 MCP 服务器是长驻进程,直接在主进程运行 python server.py 或 node dist/index.js 会挂起,建议用评估框架、tmux 或 timeout 5s python server.py 测试。

适用场景与限制:适合需要为 LLM 构建外部服务集成工具的开发者。限制:完整流程依赖网络获取文档;评估题需人工验证答案;具体收费、价格与平台支持情况暂未提供。