MCP Server Cgb

🚀 MCP サーバー

MCP サーバーは、Model Context Protocol (MCP) プロトコルに基づくサーバーです。これにより、大規模言語モデル（LLMs）が外部ツールや外部サービスと標準的な方法で相互作用することが可能になります。

✨ 主な機能

• 複数のツール（電卓、天気、検索）をサポート
• FastAPI ベースの RESTful API
• Pydantic を使用したデータ検証
• 効率的な非同期処理
• API ドキュメントの自動生成（Swagger UI 付き）

📦 インストール

システム要件

• 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: /
• メソッド: GET
• 説明: サーバーに関する情報とサポートされているツールのリストを返します。

2. ツールの実行

• URL: /execute
• メソッド: POST
• 説明: 提供されたパラメーターを使用してツールを実行します。
• リクエストボディ:

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

サポートされているツール

1. 電卓

• 基本的な数学演算を実行します。
• パラメーター:
  • operation: "add" または "multiply"
  • numbers: 計算する数字の配列

2. 天気

• 特定の場所の天気情報を取得します。
• パラメーター:
  • location: 場所の名前

3. 検索

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

API ドキュメント

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

📚 ドキュメント

新しいツールの追加

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

テストの実行

pytest

📄 ライセンス

MIT License