尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
claude-skills MCP Developer实战:开发Model Context Protocol工具
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),仅供参考
RELATED

相关推荐

ADC评估套件实战:从EVK选型到高频性能测试的关键指标与供应链策略

ADC评估套件实战:从EVK选型到高频性能测试的关键指标与供应链策略

前阵子做某工业采集项目,选一颗16位ADC,前后对比了五六家方案。真正被卡住的不是芯片指标,而是评估板。你不是买不到芯片,而是根本拿不到一块像样的EVK去验证,好不容易托关系搞到一家,价格贵得离谱&#xf…

📅 2026/11/7 2:48:03
36V 4A小封装DC-DC Buck模块:选型、设计、实测全解析

36V 4A小封装DC-DC Buck模块:选型、设计、实测全解析

前段时间调一块便携式数据采集设备的电源板,系统里6节锂电池串联供电,满电电压25.2V,还得兼容24V工业适配器,板子总面积被结构卡死,给电源部分就留了不到半个信用卡大的地方。绕了一圈之后,我把目光落在36V…

📅 2026/11/6 19:38:14
电动汽车高压系统模拟IC选型与参考设计实战指南

电动汽车高压系统模拟IC选型与参考设计实战指南

前阵子帮一位做BMS的朋友调试一块采样板,现象是高压侧数据偶尔丢帧,低压侧主控读到的电芯电压有1~2mV的跳动。他把板子翻来覆去检查了很多遍,最后问题出在两个地方:隔离器两边的地之间寄生电容处理不当,以及参考设计里…

📅 2026/9/28 18:31:11
MORE NEWS

更多资讯

📰

四川机建电工证在外省能转过来吗?官方报名入口在这里

四川机建电工证在外省能转过来吗?官方报名入口在这里 之前考的证在外省能不能转过来?这个问题几乎每个在外地打工的四川机建电工证持有人都会遇到。尤其是现在跨省作业越来越频繁,很多人在别的省份工作,但证件却在老家,想用又怕麻烦。其实,只要按照流程…

📰

四川机建电工证上岗必备,没有它就别想找工作了

四川机建电工证上岗必备,没有它就别想找工作了 你是不是正愁找不到工作?是不是看到招聘信息写着“持证上岗”就心里没底?别急,今天咱们就来聊聊 四川机建电工证 这事儿,特别是你最关心的—— 上岗必备 的这张证到底能不能让你顺利找到工作。…

📰

深圳考电工证自备工具怎么操作?证书含金量到底多高

深圳考电工证自备工具怎么操作?证书含金量到底多高 证书过期了不知道怎么复审延期,这种焦虑不少电工从业者都有过。特别是像你这样在一线干了几年,手上的证书眼看就要到期,却不知道怎么操作,生怕一不小心就丢了饭碗。其实, 深圳考电工证自备工具…

📰

周贤正的电工证怎么报名才靠谱?怕考不过白交培训费

周贤正的电工证怎么报名才靠谱?怕考不过白交培训费 怕考不过白交培训费?周贤正的电工证报名别再乱花钱了!很多在洛阳做建筑工的朋友都遇到过,报了个培训班,花了钱,结果考试还是挂了,培训费打水漂,还耽误工作。其实,周贤正的电工证报名没那么复杂,关…

📰

你学历不高怕报不上名?常见的特种作业操作证多少钱一证全解析

你学历不高怕报不上名?常见的特种作业操作证多少钱一证全解析 你学历不高怕报不上名?其实,常见的特种作业操作证报考门槛并不高,关键看你选对了工种和机构。今天咱们就来聊聊 常见的特种作业操作证…

📰

电工证解绑怎么操作?网上查询教你一步步完成

电工证解绑怎么操作?网上查询教你一步步完成 证书过期了不知道怎么复审延期?你不是一个人在战斗。尤其是像我们这些常年在工地、项目部跑动的劳务班组负责人,经常遇到工人拿着过期的电工证上岗,结果被检查部门一查,不仅罚款,还可能被清退。最近我就遇到…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬