MCP Server

MCP サーバー

MCP サーバーは、Model Context Protocol（MCP）を実装するサーバーであり、大規模言語モデル（LLM）が外部のツールやサービスと標準化された方法でやり取りできるようにします。

機能

• さまざまなツールに対応（calculator、weather、search）
• FastAPI による RESTful API
• Pydantic によるデータ検証
• 効率的な非同期処理
• Swagger UI による API ドキュメントの自動生成

システム要件

• Python 3.8+
• pip（Python パッケージマネージャー）

インストール

1. リポジトリをクローンします：

git clone <repository-url>
cd mcp-server

2. 仮想環境を作成して有効化します：

python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

3. 必要なライブラリをインストールします：

pip install -r requirements.txt

サーバーの起動

python main.py

サーバーは次のアドレスで起動します：http://localhost:8000

API エンドポイント

1. ルートエンドポイント

• URL: /
• Method: GET
• Description: サーバーの情報と、対応しているツールの一覧を返します

2. ツールの実行

• URL: /execute
• Method: POST
• Description: 指定されたパラメーターを使ってツールを実行します
• Request Body:

{
  "tool_name": "calculator",
  "parameters": {
    "operation": "add",
    "numbers": [1, 2, 3]
  },
  "context": {}
}

対応しているツール

1. Calculator

• 基本的な計算を実行します
• パラメーター：
  • operation：「add」または「multiply」
  • numbers：計算する数値の配列

2. Weather

• 指定した場所の天気情報を取得します
• パラメーター：
  • location：場所の名前

3. Search

• ウェブ検索を実行します
• パラメーター：
  • query：検索キーワード

API ドキュメント

http://localhost:8000/docs にアクセスすると、Swagger UI で完全な API ドキュメントを確認できます。

開発

新しいツールの追加

1. SUPPORTED_TOOLS にツール名と説明を追加します
2. process_tool_request に新しい処理関数を追加します
3. 新しいツール専用の処理関数を作成します

テストの実行

pytest

ライセンス

MIT License