用途:该技能汇总截至2025年底的MCP(Model Context Protocol)服务器设计、实现与集成最佳实践,帮助开发者构建可被Claude Code等宿主调用的MCP服务器。
主要能力与模式:
- 架构基础:MCP客户端层负责服务器发现与连接、工具注册与调用、资源管理与提示模板;服务器提供工具(可调用函数)、资源(可读数据)、提示(模板)和通知。
- 服务器设计:单一职责服务器、资源优先设计、按域分层组织工具。
- 工具设计:使用动作导向的清晰命名(如create_issue、list_repositories),提供完整inputSchema,返回结构化、可预测数据并附建议后续操作。
- 安全:凭据隔离(存于环境变量、启动时校验、不记录或暴露),使用Zod等做输入校验,速率限制,审计日志。
- 多服务器编排:在配置中组合多个服务器,跨服务器工作流由Claude自动协调,服务器暴露健康检查。
- 性能:连接池、LRU缓存、批量操作(带并发限制)。
- 错误处理:结构化错误响应(如MCPError)、优雅降级。
- 测试:使用vitest进行单元测试与集成测试,验证工具列表、参数校验和调用结果。
使用方式:在宿主(如Claude Code)配置中以command和env声明各MCP服务器并组合使用;命名建议采用mcp__<server>__<action>格式。
限制:资料主要给出设计模式与代码示例,未提供具体安装命令、收费信息或独立运行步骤;实际部署需结合各服务器自身接口与凭据配置。