MCP Cookie Cutter

🚀 MCP 服务器 Cookie Cutter 模板

MCP 服务器 Cookie Cutter 模板用于创建全新的 MCP（机器控制协议）服务器。它能生成具备完整功能的 MCP 服务器，支持统一传输处理（涵盖标准输入输出和 SSE），还与 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 文件。