MCP Demo Server

🚀 MCP デモサーバー

これは、Model Context Protocol (MCP) のサーバーを簡単に実装したサンプルプロジェクトです。このプロジェクトでは、Python を使って基本的な MCP ツールを構築する方法を紹介しています。

✨ 主な機能

このプロジェクトでは、2つの簡単な MCP ツールが実装されています。

• add: 2つの整数を受け取り、その合計を返す単純な足し算関数です。
• say_hello: 名前をパラメータとして受け取り、挨拶文を返す挨拶関数です。

🔧 技術詳細

📦 インストール

1. プロジェクトをクローンする

git clone [repository-url]
cd mcp-demo

2. 仮想環境を作成し、依存関係をインストールする

python -m venv .venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate
pip install mcp[cli]

💻 使用例

基本的な使用法

MCP サーバーを起動するには、以下のコマンドを実行します。

uv run --with mcp[cli] mcp run server.py

📚 ドキュメント

プロジェクト構造

mcp-demo/
├── server.py        # MCP サーバーのメインプログラム
├── .gitignore      # Git が無視するファイル
└── README.md       # このドキュメント

開発に関する説明

サーバーでは、2つの基本的なツールが実装されています。

1. add(a: int, b: int) -> int

   • 機能：2つの整数を足し合わせます。
   • パラメータ：
     • a: 最初の整数
     • b: 2番目の整数
   • 戻り値：2つの数値の合計

2. say_hello(name: str) -> str

   • 機能：個人用の挨拶文を生成します。
   • パラメータ：
     • name: 挨拶する対象の名前
   • 戻り値：挨拶文を含む文字列

設定

このプロジェクトには、VS Code 用の設定ファイル (.vscode/mcp.json) が含まれており、VS Code で直接 MCP サーバーを実行してテストすることができます。

サーバーのテスト

開発モードで MCP サーバーをテストするには、以下のコマンドを実行します。

mcp dev server.py

このコマンドは、以下のことを行います。

1. 開発モードでサーバーを起動します。
2. コードの変更を自動的に再読み込みします。
3. より詳細なデバッグ情報を提供します。

GitHub Copilot の設定

GitHub Copilot でこの MCP サーバーを使用するには、VS Code で以下の手順を設定します。

1. プロジェクトのルートディレクトリに .vscode フォルダを作成します（まだ存在しない場合）。

2. .vscode フォルダに mcp.json ファイルを作成し、以下の内容を記述します。

{
    "servers": {
      "Demo": {
        "command": "uv",
        "args": [
          "run",
          "--with",
          "mcp[cli]",
          "mcp",
          "run",
          "${workspaceFolder}/server.py"
        ]
      }
    }
}

3. 設定が完了すると、GitHub Copilot は自動的に MCP サーバーに接続し、提供されているツール機能を使用することができます。

⚠️ 重要提示

• uv パッケージ管理ツールが正しくインストールされていることを確認してください。
• ${workspaceFolder} は、自動的にプロジェクトのルートディレクトリのパスに置き換えられます。
• 異なる Python 環境管理ツールを使用する場合は、適宜設定を調整してください。