MCP Server Cookie Cutter 模板

用于创建新的 MCP（模型上下文协议）服务器的模板。此模板生成一个具有统一传输处理（标准输入输出和服务器发送事件）和 MCP Inspector 兼容性的完全功能的 MCP 服务器，通过简单的回显服务进行演示。

功能

• 统一传输处理（标准输入输出和服务器发送事件在一个实现中）
• 完全兼容 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:codingthefuturewithai/mcp-cookie-cutter

方案 2：从本地副本创建

1. 克隆此模板：

   git clone https://github.com/codingthefuturewithai/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 文件。 </中文翻译>