mcpField
M
mcp-builder

mcp-builder

github.com/dkyazzentwatwa开发126190 次安装29 周前更新
代码仓库

关于 mcp-builder

用于围绕完整用户工作流设计和实现 MCP 服务的技能,指导开发者从 API 调研、工具设计到基础设施搭建和实际评估。

主要功能

  1. 01面向工作流的工具设计
  2. 02工具架构与文档字符串
  3. 03身份验证与请求辅助功能
  4. 04分页与响应格式化
  5. 05服务评估资源

适用场景

  1. 01根据 API 文档规划 MCP 工具
  2. 02构建 Python 或 TypeScript MCP 服务
  3. 03改进错误消息和工具输出
  4. 04通过实际任务评估服务可用性

MCP 相关

指导开发者创建 MCP 服务,包括工具清单、输入输出架构,以及评估提示词或脚本。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/dkyazzentwatwa/chatgpt-skills --skill mcp-builder

安装后在 Claude Code 中输入/mcp-builder确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

LICENSE.txt
agents/
openai.yaml
references/
evaluation.md
mcp_best_practices.md
node_mcp_server.md
python_mcp_server.md
scripts/
connections.py
evaluation.py
example_evaluation.xml
requirements.txt

详细介绍

MCP 构建器

围绕用户工作流构建 MCP 服务,而不是围绕原始 API 端点。

工作流

  1. 阅读目标 API 文档,找出 Agent 必须端到端完成的工作流。
  2. 设计一组精简的工具,提供高信号输出、清晰的标识符和可操作的错误信息。
  3. 优先实现通用基础设施:身份验证、请求辅助工具、分页、截断和格式化。
  4. 添加工具 schema 和文档字符串,让正确的用法一目了然。
  5. 在扩大范围之前,使用真实任务评估服务。

原则

  • 优先选择工作流工具,而不是轻量的端点封装。
  • 默认返回简洁且高信号的响应。
  • 尽可能使用易读的标识符。
  • 让错误消息具有指导性:告诉 Agent 下一步可以尝试什么。
  • 针对有限的上下文和大型数据集进行设计。

资源

  • references/mcp_best_practices.md:适用于每个服务的设计原则。
  • references/python_mcp_server.md:Python 实现模式。
  • references/node_mcp_server.md:TypeScript 实现模式。
  • scripts/connections.py 和 scripts/evaluation.py:仓库本地辅助工具。

交付内容

  • 与用户工作流对应的具体工具清单。
  • 严格的输入/输出 schema。
  • 用于确认 Agent 能够使用该服务的评估提示词或脚本。

评论

支持 Markdown