MCP Examples

🚀 MCPサンプルプロジェクト

このプロジェクトは、モデルコンテキストプロトコル（MCP）のサーバーとクライアントのセットアップを実証しています。これには、Dockerコンテナ内でサーバーを実行するためのツールと設定が含まれています。

🚀 クイックスタート

プロジェクト構造

.
├── Dockerfile                # MCPサーバーのDockerビルド命令
├── pyproject.toml            # Pythonプロジェクトの設定
├── uv.lock                   # 依存関係のロックファイル
├── README.md                 # プロジェクトのドキュメント
├── client/                   # クライアント側のコード（ある場合）
└── servers/                  # MCPサーバーの実装
    ├── __init__.py
    ├── main.py               # サーバーのメインエントリーポイント
    └── tools/                # 追加のサーバーツール
        ├── __init__.py
        ├── calendar.py       # カレンダーツールの実装
        ├── task_manager.py   # タスクマネージャーツールの実装
        └── weather.py        # 天気ツールの実装

Dockerイメージのセットアップとビルド

1. Dockerイメージのビルド

   プロジェクトのルートディレクトリから以下のコマンドを実行します。

   docker build -t mcp-example-stdio-server:latest .
   

   これにより、MCPサーバーを含む mcp-example-stdio-server:latest という名前のDockerイメージが作成されます。

2. サーバーの実行（スタンドアロン）

   以下のコマンドでサーバーを直接実行できます。

   docker run --rm -i mcp-example-stdio-server:latest
   

   サーバーが起動し、MCPの標準入出力要求を待機します。

mcp.json の設定

.vscode/mcp.json ファイルは、開発環境（例：VS Code）でMCPサーバーを起動する方法を設定します。

{
  "servers": {
    "example-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp-example-stdio-server:latest"
      ]
    }
  },
  "inputs": []
}

• type: stdio は、サーバーが標準入出力を介して通信することを示します。
• command: サーバーを起動するコマンド（docker）。
• args: ビルドしたイメージでDockerコンテナを実行するための引数。

この設定により、開発ツールはコンテナ化された環境でMCPサーバーを自動的に起動できます。

追加の注意事項

⚠️ 重要提示

• システムにDockerがインストールされ、実行されていることを確認してください。
• サーバーコードを変更した後は、必要に応じてDockerイメージを再構築して更新してください。
• servers/tools/ ディレクトリには、必要に応じて拡張できるモジュール型のツール実装が含まれています。