工具集成 · 技能模板

MCPBuilderSkill

官方 mcp-builder 技能封装了构建 Model Context Protocol 服务器的全流程指引，从定义工具接口、校验入参到生成文档与测试剧本，帮助你在 Claude Agents 与外部系统之间安全集成 API。

工作流概览

询问目标 API、鉴权方案与速率限制，生成接口设计草稿。
输出 `server/` 目录结构，包含 typer CLI、测试与示例配置。
生成 README、USAGE 与 OpenAPI 摘要，帮助团队接入。

资源文件

`instructions/scaffold.md` —— 引导提问与生成服务器脚手架。
`templates/tool_prompt.md` —— 约束工具描述与入参校验。
`examples/` —— 包含 Slack、GitHub 等集成示例。

SKILL.md 精选片段

---
name: mcp-builder
description: Create production-ready MCP servers with rigorous interface design and testing.
workflow:
  - Capture requirements and constraints
  - Scaffold server boilerplate and example handlers
  - Produce verification tests + README
safety:
  - Validate authentication paths
  - Document rate limits and failure modes
keywords: [mcp, integration, agents, sdk]

落地要点

推荐与内部安全团队协作，先在 staging 环境验证脚本，再发版到生产。可在 PR Checklist 中加入“已运行 e2e tests” 与 “已更新 API 限流配置” 项，确保发布质量。

若已有现成 SDK，可把核心逻辑抽象到 `lib/`，在指令中提醒 Claude 调用，而不是重复生成代码，提高迭代效率。