MCP服务器开发指南

《史密斯里食谱》

《Smithery烹饪书》提供了代码示例和指南，旨在帮助开发人员构建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
   # Follow the README.md instructions
   

3. 在Smithery Playground进行测试：

   复制

   npx @smithery/cli playground --port 8081
   

   注：更换 8081 与你的服务器运行所使用的端口

4. 部署到Smithery（可选）： 准备好分享你的MCP服务器了吗？ 在此部署 在Smithery平台上托管它。

食谱表

Python 服务器

• FastMCP 快速入门 - 基本服务器，配备问候工具
• FastMCP Advanced 翻译为中文是：“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 社区 - 寻求帮助并分享你的项目

如果你有新的示例或指南的想法，请在（相关平台/社区）上分享它们 问题页面.

许可证

麻省理工学院许可证