Smithery Cookbook：做 MCP 服务器的保姆级教程，终于有人写出来了

说实话，MCP 服务器的开发文档我看过不少，大多数要么太简陋、要么太分散，搞个最小可用的 Demo 得东拼西凑。今天介绍一个让我眼前一亮的项目——Smithery Cookbook。

Smithery 大家应该不陌生了，海外最大的 MCP 服务器注册表 + 托管平台，接入 Claude/Cursor 等主流 AI 编程工具特别方便。但他们最近开源的 Cookbook 项目，是专门给开发者学做 MCP 服务器的配方书——保姆级教程，覆盖 Python（FastMCP）和 TypeScript 两条主流路线。

🔥 先说最重要的：能学到什么

Cookbook 里的示例不是那种”Hello World”级别的玩具，每一个都对应真实开发场景：

• FastMCP Python Quickstart：用 FastMCP 框架 5 分钟跑起一个带工具的 MCP 服务器，配环境到本地运行到调试，全流程跑通。
• FastMCP Advanced：进阶版，讲 Session 配置怎么玩——做生产级服务这个必须掌握。
• STDIO 迁移到 HTTP：很多现有 MCP 服务器是 STDIO 传输模式，怎么无缝切换到 HTTP 模式部署到云端，Cookbook 给了完整方案。
• 自定义 Docker 容器：用 Docker 容器来跑 MCP 服务器，带 Dockerfile 和部署配置。
• TypeScript Quickstart：Node.js 技术栈的同学可以直接用这套，同样覆盖基础工具定义和调试。

🔧 开发体验怎么样

Cookbook 推荐用 npx @smithery/cli playground --port 8081 启动一个交互式 Playground，浏览器里就能实时调试你写的 MCP 工具——请求响应一目了然，不用每次改了代码重启服务再手动 curl 测试。

部署也简单：代码推 GitHub，然后在 smithery.ai 上连接仓库，平台自动构建托管，你得到一个公开可用的 MCP 端点，任何 MCP 兼容的 AI 客户端都能直连。

💡 为什么值得收藏

MCP 这套协议正在快速标准化，Anthropic、OpenAI、Google 都在推。未来 AI 编程工具的能力边界，很大程度上取决于接了多少外部工具——也就是 MCP 服务器生态。

Cookbook 正好填补了一个空白：没有门槛的系统性学习资源。不管你是想给自己的内部 API 写一个 MCP 包装器，还是想做一个对外的工具服务，Cookbook 都能让你从零到上线少走弯路。

项目只有 20 Stars（刚起步），但内容质量很高，而且 MIT 协议——可以随便用。建议先收藏，等哪天你需要接 MCP 的时候，这就是最好的起手式。

GitHub：https://github.com/clavia-labs/smithery-cookbook

GitHub: https://github.com/clavia-labs/smithery-cookbook