claude-skills MCP Developer实战开发Model Context Protocol工具【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills想用 Claude 连接数据库、调用 API 或操作文件系统MCPModel Context Protocol模型上下文协议就是那个标准接口。本文以 claude-skills 项目中的MCP Developer技能为实战蓝本带你从零理解如何开发一个规范的 MCP 工具MCP Server6 步开发流程、Tools/Resources/Prompts 三大核心概念、stdio 与 HTTP/SSE 传输选择以及新手最容易踩的协议合规与输入校验坑。无需精通底层协议跟着清单走就能交付第一个可运行的 MCP 工具。什么是 MCPAI 与外部工具之间的USB 接口 MCP 基于JSON-RPC 2.0协议让 AI 客户端如 Claude Desktop与外部工具服务器双向通信。它解决一个核心问题AI 模型本身只会说话而 MCP 工具让它能真正动手——查天气、读文件、执行 SQL 查询。一次 MCP 工具调用的完整生命周期只有 7 步来自 protocol.md客户端通过 stdio / HTTP / SSE 发起连接客户端发送initialize请求服务器返回自身能力声明客户端回发initialized通知握手完成进入正常阶段tools/call、resources/read等请求双方可随时ping保活客户端发送shutdown连接关闭claude-skills 中 MCP Developer 技能如何快速上手 在 claude-skills 的技能速查表 SKILLS_GUIDE.md 中MCP Developer被归类于 API Architecture 领域定位是Model Context Protocol 开发与集成专家。安装技能后参考 QUICKSTART.md 的任一安装方式只要在对话中提及 MCP server、MCP 工具、JSON-RPC 等关键词Claude 就会自动加载该技能的专业上下文。技能的完整定义在 SKILL.md其中 frontmatter 声明了触发词MCP、Model Context Protocol、MCP server、JSON-RPC 等并关联了fastapi-expert、typescript-pro、security-reviewer等相关技能。从零开发 MCP 工具的 6 步流程 SKILL.md 定义了标准的六步核心工作流这也是所有 MCP 工具开发项目的通用路径步骤动作关键点① 分析需求明确数据源、所需工具、客户端应用先画边界再写代码② 初始化项目TypeScriptnpx modelcontextprotocol/create-serverPythonpip install mcp官方脚手架二选一③ 设计协议定义资源 URI、工具 SchemaZod/Pydantic、Prompt 模板Schema 是 AI 理解工具的依据④ 实现注册工具与资源处理器配置 stdio/SSE/HTTP 传输层传输层与业务逻辑分离⑤ 测试用npx modelcontextprotocol/inspector交互验证失败则回到第③步修 Schema⑥ 部署打包、加认证与限流、配置环境变量、监控没有限流不上线第 ⑤ 步内建了反馈闭环Schema 校验失败 → 检查 Zod/Pydantic 报错 → 修定义 → 重跑 inspector工具返回畸形响应 → 检查传输层序列化 → 修 handler → 再测。这套循环是 MCP 工具调试的主旋律。3 个核心概念Tools、Resources、Prompts MCP 服务器对外提供三类能力理解它们的分工是开发 MCP 工具的前提1. Tools工具——让 AI 执行动作工具是 AI 可调用的函数每个工具必须有清晰的名字与描述、JSON Schema 定义的输入参数。调用时走tools/call方法响应是结构化的content数组文本、图片、资源引用皆可。参数支持字符串、枚举、嵌套对象、数组等模式详见 tools.md。 最佳实践给工具起名search_knowledge_base而不是search描述写清楚返回前 5 条相关文档及摘录——描述质量直接决定 AI 会不会、会不会正确使用你的工具。2. Resources资源——让 AI 读取数据资源用 URI 标识如db://users/schema、file:///config/app.json支持文件、数据库、API、Git 仓库等多种来源还提供 URI 模板实现动态寻址如user://{user_id}/profile与订阅更新推送。设计要点URI 要分层、语义清晰内容要标注正确 MIME 类型文件类资源务必做路径越权防护。详见 resources.md。3. Prompts提示词模板——让 AI 按套路出牌通过prompts/get提供可复用的参数化提示词例如固定的代码审查话术。三者配合就覆盖了读数据 执行动作 规范输出的完整闭环。TypeScript 还是 Python两大官方 SDK 怎么选 技能为两种技术栈各提供了完整实现参考TypeScriptnpm install modelcontextprotocol/sdk zod用 Zod 校验输入StdioServerTransport一行接入本地传输完整代码模式见 typescript-sdk.md。适合前端/Node 团队。Pythonpip install mcp pydanticFastMCP 框架用装饰器mcp.tool()即可注册一个 Pydantic 校验的工具函数见 python-sdk.md。适合后端/AI 团队。一个最小工具的心智模型以 Python 为例实际实现见 SKILL.mdmcp.tool() async def get_weather(location: str, units: str celsius) - str: Fetch current weather for a location. return str(await fetch_weather(location, units))注册工具、声明资源、mcp.run()启动剩下的 JSON-RPC 握手全部由 SDK 托管——新手不需要手写任何协议报文。传输层与协议合规2 种连接方式怎么选 传输层工作方式适用场景stdio标准输入/输出换行分隔 JSON本地集成Claude Desktop 默认开发首选HTTP SSE客户端 POST 请求服务器经 SSE 流式返回远程服务器、跨机器调用协议版本当前为2024-11-05服务器必须在initialize响应中声明版本。常见错误码遵循 JSON-RPC 2.0 标准如-32602参数非法MCP 另有实现级扩展如-32004限流触发。完整的请求/响应报文示例在 protocol.md。MCP 工具开发的红线清单 SKILL.md 用 MUST / MUST NOT 两份清单锁死了质量底线新手对照自查必须做到 ✅正确实现 JSON-RPC 2.0用 Zod/Pydantic 校验所有工具输入完善的错误处理 认证授权 协议消息日志彻底测试协议合规性文档化服务器能力坚决不做 ❌跳过工具输入校验这是新手第一大坑在资源内容里暴露敏感数据、硬编码密钥同步代码混入异步传输层无结构化错误、无限流直接部署⚠️ 经验法则请求超时建议 30 秒、工具调用尽量设计成幂等幂等键idempotency_key、所有协议消息留日志——这三条能消灭 80% 的线上诡异故障。延伸资料MCP 开发实战路径图 ️把下面这份清单收好按顺序推进即可完成第一个生产级 MCP 工具技能主文档与六步工作流skills/mcp-developer/SKILL.md协议规范消息类型/生命周期/错误码/传输references/protocol.md工具定义与 7 大最佳实践references/tools.md资源 URI 设计与订阅模式references/resources.mdTypeScript / Python SDK 实现参考references/typescript-sdk.md、references/python-sdk.mdMCP 工具开发的门槛并不高选一个数据源天气 API、你的业务数据库、本地文件都行按 6 步流程走一遍用 inspector 验证通过你就拥有了第一个能让 AI 真正动手干活的 Model Context Protocol 工具。【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考