MCP Cookie Cutter

🚀 MCP サーバー Cookie Cutter テンプレート

このテンプレートは、新しい MCP（マシン制御プロトコル）サーバーを作成するための Cookie Cutter テンプレートです。このテンプレートを使用すると、統一されたトランスポート処理（標準入出力と SSE）を備え、MCP Inspector と互換性のある完全に機能する MCP サーバーを生成できます。簡単なエコーサービスを通じてその機能がデモンストレーションされています。

✨ 主な機能

• 統一トランスポート処理（標準入出力と 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 ファイルを参照してください。