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 文件。