MCP Agent Tool Adapter

🚀 mcp-agent-tool-adapter

協議からインテリジェンスへ：MCPでエージェントを動かす。

🚀 クイックスタート

MCPエージェントツールアダプター は、MCPプロトコル を通じてモジュール化されたツール呼び出しを実現し、Google ADK または LangGraph に基づくエージェントを提供します。これにより、これらのエージェントは動的にツールと推論を行うことができます。

✨ 主な機能

• このプロジェクトは、MCPツールを以下のように変換します：
  • 🤖 ストリーミングFastAPIまたはCLIインターフェース付きのGoogle ADKエージェント
  • 🧠 ReAct + ストリーミングツール計画を使用するLangGraphエージェント
• モジュール化されたツール呼び出し：複数のツールの柔軟な呼び出しをサポートします。
• ストリーミングインターフェース：効率的なストリーミングデータ処理能力を提供します。
• 多言語対応：さまざまなプログラミング環境やフレームワークに適合します。

📦 インストール

☑️ 前提条件

• Python 3.10+

⚙️ インストール手順

# このリポジトリをクローンする
❯ git clone https://github.com/serkanyasr/mcp-agent-tool-adapter
❯ cd mcp-agent-tool-adapter

# 依存関係をインストールする
❯ pip install -r requirements.txt

💻 使用例

基本的な使用法

Google ADK CLIエージェントを実行する：

❯ python app_client_adk.py

LangGraph ReAct CLIエージェントを実行する：

❯ python app_client_langgraph.py

mcp_config.json でツールを定義することを確認してください。例えば：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modular-protocol/filesystem"]
    }
  }
}

📚 ドキュメント

🧱 プロジェクト構造

mcp-agent-tool-adapter/
├── mcp_client/                # コアクライアントの実装（モジュール化）
│   ├── client.py              # MCPClient & MCPServer
│   ├── tool_loader.py         # 高レベルの非同期ローダー
│   └── types.py               # 共有タイプ定義
├── app_client_adk.py         # Google ADKエージェント + CLIチャット
├── app_client_langgraph.py   # LangGraphエージェント + ReAct CLIチャット
├── mcp_config.json           # サンプルMCPツール設定
├── requirements.txt          # 依存関係
└── README.md

🧠 ツールアーキテクチャ

MCPツールは MCPClient を通じてエージェントに接続し、以下のことを処理します：

• ツールサーバーの起動（子プロセスを介して）
• セッション管理
• ツールアダプター（langgraphまたはGoogle ADK）
• クリーンアップ作業

アプリケーション内の tool_type を "google" または "langgraph" に変更することで、エージェントタイプを動的に切り替えることができます。

🧪 開発とテスト

プロジェクトフロー

1. 初期化：MCPサーバーを構成し、必要なツールをロードします。
2. エージェント起動：Google ADKまたはLangGraphエージェントを実行してリクエストを受け取ります。
3. ツールインタラクション：必要に応じて動的に対応するツールを呼び出して処理します。
4. 結果フィードバック：処理結果をストリーミングインターフェースを通じてクライアントに返します。

注意事項

⚠️ 重要提示

• fastapi や langchain などのすべての依存関係がインストールされていることを確認してください。
• 設定ファイルでツールのパスとパラメータを正しく指定し、実行時エラーを避けてください。
• 大規模データを処理する場合は、パフォーマンスを向上させるためにネットワーク伝送とリソース管理を最適化することをおすすめします。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。