MCP-Workshop

Claude官方MCP开发实战工作坊,从零构建MCP服务器与客户端。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:MCP-Workshop。
它的用途是:Claude官方MCP开发实战工作坊,从零构建MCP服务器与客户端。
完整的 Skill 内容见:https://321skill.com/skills/mcp-workshop/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我把下周三下午3点的团队会议添加到日历里。”,它会调用你集成好的日历MCP服务器工具,完成事件的创建与存储。或者,你可以直接提问:“计算一下项目总成本,原材料费是12500元,人力成本是7800元。”,Claude会自动使用你集成的计算器工具给出准确结果。

介绍

本工作坊旨在解决开发者入门MCP(Model Context Protocol)框架时缺乏系统性、手把手指导的问题。它提供了一个结构化的学习路径,通过构建计算器和日历等具体MCP服务器,再到开发命令行和图形界面客户端,让开发者透彻理解MCP的核心概念与完整工作流。

使用方式清晰直接:按照仓库中的模块顺序,从环境搭建开始,逐步完成每个模块的代码编写与运行。用户需要配置好Python环境和Anthropic API密钥,然后通过修改Claude Desktop配置文件来集成自己开发的MCP服务器,从而在Claude中直接调用这些工具。

它非常适合希望将自定义功能或数据安全、可控地接入Claude等AI助手的开发者,特别是对Python有一定基础,并有意探索AI Agent生态和工具扩展能力的人群。无论是智能体开发者、全栈开发还是对AI应用集成感兴趣的后端工程师,都能从中获益。

请注意,本工作坊侧重于教学和实践,产出的MCP服务器示例(如日历)使用内存存储,不适合生产环境直接使用。学习过程中需确保已安装uv工具并正确配置绝对路径,这是成功集成到Claude Desktop的关键。

核心特点

这是由Claude官方社区(Claude Builder Club)推出的、体系化且包含完整客户端开发教程的MCP实战课程,而非单个功能工具。其核心区别在于提供了从“服务器”到“客户端”的双视角完整开发闭环,并配有详细的Claude Desktop集成配置指南,降低了MCP的学习与应用门槛。

注意事项

工作坊中的示例服务器(如日历)为教学演示而设计,采用内存存储,数据不持久,不适合直接用于生产环境。

常见问题

如何将我自己开发的MCP服务器添加到Claude Desktop中使用?

按照工作坊Step 1的指引,编辑Claude Desktop的MCP配置文件(claude_desktop_config.json),使用uv命令并指定服务器文件的绝对路径即可。

运行示例代码前需要准备什么?

需要安装Python 3.10+、uv包管理工具,并在Anthropic官网获取API密钥配置到项目.env文件中。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/mcp-workshop/raw/index.md 读取 MCP-Workshop 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。