MCP构建器技能
Claude Code Desktop的综合技能，可作为构建生产就绪MCP（模型上下文协议）服务器的权威指南。
概述
MCP Builder技能为使用以下两种方法创建高质量、可维护的MCP服务器提供了实用、可操作的指导 FastMCP（Python） 和 MCP SDK（节点/TypeScript）。此技能涵盖了从基础知识到生产部署的所有内容，并提供了真实世界的示例和最佳实践。
特性
- 📚 全面覆盖：涵盖MCP服务器开发各个方面的完整指南
- 🔄 双重实施：FastMCP（Python）和MCP SDK（TypeScript）的深度覆盖相等
- ✅ 最佳实践：安全、错误处理、测试和生产准备指南
- 💡 真实世界的例子：GitHub API、Notion API、数据库和文件操作的完整工作示例
- 🎯 可操作指南：没有理论上的废话——一切都可以立即付诸行动
- 📋 质量检查表：实施质量验证清单
- 🌳 决策树：架构决策指导
目录
该技能涵盖了以下方面：
- MCP基础 -协议架构、传输层、客户端-服务器通信模式
- 工具设计原则 -原子操作、输入/输出合同、参数验证
- 实现模式 -REST API、数据库、文件系统、身份验证流
- 错误处理 -显式错误类型、重试逻辑、超时处理、优雅降级
- 测试策略 -单元测试、集成测试、模式验证、身份验证测试
- 安全最佳实践 -API密钥管理、输入净化、速率限制
- 文件标准 -LLM友好的描述、参数文档、使用示例
- 生产准备就绪 -配置管理、部署、监控、版本控制
- 常见的陷阱 -要避免的反模式、性能瓶颈、常见错误
- 真实世界的例子 -常见用例的完整工作示例
安装
适用于Claude Code桌面
- 克隆或下载此存储库
- 复制
mcp-builder-skill.md文件到您的Claude技能目录：
mkdir -p ~/.claude/skills/mcp-builder-skill
cp mcp-builder-skill.md ~/.claude/skills/mcp-builder-skill/SKILL.md- 打开克劳德代码桌面
- 导航至 设置 → 能力 → 技能
- 找到 “MCP生成器” 在列表中并切换它 开
替代方案：以ZIP格式上传
- 创建一个名为的目录
mcp-builder-skill - 复制
mcp-builder-skill.md将其重命名为SKILL.md - 将目录压缩为
mcp-builder-skill.zip - 在克劳德代码桌面中： 设置 → 能力 → 技能 → 上传技巧
用法
安装并启用后，您可以通过向Claude提出以下问题来使用该技能：
- “帮助我为GitHub API集成构建MCP服务器”
- “演示如何在FastMCP中实现正确的错误处理”
- “MCP服务器中工具设计的最佳实践是什么？”
- “为\[您的API\]创建一个生产就绪的MCP服务器”
- “如何处理MCP服务器中的速率限制？”
该技能将根据您的查询自动提供全面的指导。
你将学到什么
使用此技能后，您将能够：
- ✅ 根据API规范生成可生产的MCP服务器
- ✅ 对工具粒度和结构做出明智的决策
- ✅ 自动执行正确的错误处理和验证
- ✅ 在没有提示的情况下编写全面的测试
- ✅ 默认情况下遵循安全最佳实践
- ✅ 生成通过审查且无重大修订的代码
文件结构
MCP-Builder-Skill/
├── README.md # This file
├── mcp-builder-skill.md # The main skill file (rename to SKILL.md for installation)
└── DEPLOYMENT_COMPLETE.md # Deployment instructions and troubleshooting需求
- 克劳德代码桌面（用于使用该技能）
- Python 3.11+（用于FastMCP示例）
- Node.js 20+（用于MCP SDK示例）
- 异步编程的基本理解
涵盖的示例
该技能包括以下完整的工作示例：
- GitHub API集成 -创建并列出问题、拉取请求
- API集成理念 -创建页面、管理数据库
- 数据库连接 -PostgreSQL与连接池
- 文件系统操作 -安全的文件读取、写入、目录列表
- REST API集成 -正确的异步/等待模式
- 身份验证流程 -令牌管理、OAuth模式
包括最佳实践
- 🔒 安全性：API密钥管理、输入净化、SQL注入预防
- ⚡ 性能：连接池、异步模式、资源清理
- 🛡️ 错误处理：显式错误类型、重试逻辑、优雅降级
- 📝 文档：LLM友好的描述，全面的示例
- 🧪 测试：单元测试、集成测试、模式验证
- 🚀 生产：配置管理、监控、版本控制
贡献
欢迎投稿！如果您有改进、其他示例或更正，请随时提交拉取请求。
资源
许可证
这项技能是为了教育和发展目的而提供的。
支持
有关问题、疑问或建议，请在 .
______________________________________________________________________
版本: 1.0.0\ 最后更新2024年11月