MCP Cookie Cutter

🚀 MCP 服务器 Cookie Cutter 模板

MCP 服务器 Cookie Cutter 模板用于创建新的 MCP（机器控制协议）服务器。它能生成一个具备统一传输处理（标准输入输出和 SSE）的全功能 MCP 服务器，兼容 MCP Inspector，还通过简单的回声服务进行了演示。

✨ 主要特性

• 统一传输处理：实现了标准输入输出和 SSE 的统一传输处理。
• 完全兼容：与 MCP Inspector 完全兼容。
• 示例回声工具：提供了示例回声工具的实现。
• 绝对导入：整个项目使用绝对导入。
• 开发环境设置：包含开发环境的设置。
• 约束性文档模板：提供约束性文档模板。

📦 安装指南

先决条件

1. Python 3.11 或更高版本

   python --version  # 应该是 3.11 或更高版本
   

2. uv（快速的 Python 包安装器）

   # 如果你没有 uv，请运行以下命令进行安装
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Cookie Cutter

   uv pip install cookiecutter
   

🚀 快速开始

创建新的 MCP 服务器

你可以从 GitHub 或从本地模板副本直接创建一个新的 MCP 服务器。

选项 1：直接从 GitHub

cookiecutter gh:codeium/mcp-cookie-cutter

选项 2：从本地副本

1. 克隆此模板：

   git clone https://github.com/codeium/mcp-cookie-cutter
   

2. 使用本地模板创建项目：

   cookiecutter path/to/mcp-cookie-cutter
   

模板配置

在创建项目时，系统会询问以下信息：

• project_name：人类可读的名称（例如，“我的 MCP 服务器”）
• project_slug：Python 包名（例如，“my_mcp_server”）
• description：项目的简短描述
• author_name：你的名字
• author_email：你的电子邮件
• server_port：SSE 服务器的端口（默认：3001）

📚 详细文档

生成的项目结构

my_mcp_server/              # 你的项目目录
├── my_mcp_server/          # Python 包目录
│   ├── __init__.py
│   ├── client/             # 客户端实现
│   │   ├── __init__.py
│   │   └── app.py         # 测试客户端实现
│   ├── server/            # 服务器实现
│   │   ├── __init__.py
│   │   └── app.py        # 统一 MCP 服务器实现
│   └── tools/             # 工具实现
│       ├── __init__.py
│       └── echo.py       # 示例工具实现
├── pyproject.toml         # 项目配置
├── README.md             # 项目文档模板
└── DEVELOPMENT.md        # 开发指南模板

下一步

生成项目后：

1. 查看并自定义 README.md 模板。
2. 遵循 DEVELOPMENT.md 中的指导：
   • 设置开发环境。
   • 安装依赖项。
   • 运行服务器。
   • 使用示例客户端进行测试。
   • 使用 MCP Inspector。
3. 在 tools/ 目录中开始添加你自己的工具。

📄 许可证

此模板根据 MIT License 分发，具体许可证内容请参见 LICENSE 文件。