Smithery Cookbook

Smithery Cookbook 提供了代码示例和指南，旨在帮助开发者构建 MCP（模型上下文协议）服务器和客户端，提供了可以直接复制并集成到您项目中的代码片段。

预备知识

为了充分利用本手册中的示例，您需要：

• Smithery CLI：通过 npm install -g @smithery/cli 安装，以访问交互式游乐场和开发工具
• 编程语言运行时：用于探索的示例（如 Python 3.12+，Node.js 18+ 等）
• 对 模型上下文协议 (MCP) 的基本理解

快速开始

1. 克隆此仓库：

   git clone https://github.com/smithery-ai/smithery-cookbook.git
   cd smithery-cookbook
   

2. 选择一个示例并遵循其 README：

   cd servers/python/quickstart
   # 按照 README.md 中的说明操作
   

3. 使用 Smithery 游乐场进行测试：

   npx @smithery/cli playground --port 8081
   

   注意：请将 8081 替换为您服务器正在运行的端口

4. 部署到 Smithery（可选）： 准备好分享您的 MCP 服务器了吗？在这里部署，将其托管在 Smithery 平台上。

示例目录

Python 服务器

• FastMCP 快速入门 - 基本服务器，带有问候工具
• FastMCP 高级 - 带有会话配置的服务器
• 从 STDIO 迁移到 HTTP - 带有自定义 Docker 容器的服务器

TypeScript 服务器

• TypeScript 快速入门 - 简单服务器，带有字符计数工具
• TypeScript 会话配置 - 带有会话配置的服务器
• 从 STDIO 迁移到 HTTP - Smithery CLI - 使用 Smithery CLI 的服务器
• 从 STDIO 迁移到 HTTP - 自定义容器 - 带有自定义 Docker 容器的服务器

开发工作流

使用 Smithery 构建和分发您的 MCP 服务器：

1. 构建您的 MCP 服务器，使用您选择的语言和框架
2. 测试与 npx @smithery/cli playground 互动
3. 调试实时请求/响应检查
4. 部署到 Smithery 托管平台 - 在这里部署
5. 分发您的服务器将在 smithery.ai/server/{name} 获得自己的页面，供他人发现和使用

进一步探索

寻找更多资源来增强您的 MCP 开发体验？

• Smithery 文档 - 完整指南和 API 参考
• 部署您的 MCP 服务器 - 将您的服务器托管在 Smithery 平台上
• 模型上下文协议规范 - 官方 MCP 文档
• Smithery Discord 社区 - 获取帮助并分享您的项目

如果您有关于新示例或指南的想法，请在 问题页面 上分享。

许可证

MIT 许可证