mcp-agent-tool-adapter

mcp-agent-tool-adapter

プロトコルからインテリジェンスへ：MCP でエージェントを強化します。

---

📍 概要

MCP Agent Tool Adapter は、MCP プロトコルを介したモジュール式のツール呼び出しを可能にし、Google ADKまたはLangGraphを使用して、ツールを動的に推論できるエージェントを提供します。

このプロジェクトは、MCP ツールを次のものに変換します。

• 🤖 ストリーミング対応の FastAPI または CLI インターフェースを備えた Google ADK ベースのエージェント
• 🧠 ReAct とストリーミング対応のツール計画を使用する LangGraph ベースのエージェント

---

🧱 プロジェクト構成

mcp-agent-tool-adapter/
├── mcp_client/                # Core client implementation (modular)
│   ├── client.py              # MCPClient & MCPServer
│   ├── tool_loader.py         # High-level async loader
│   └── types.py               # Shared type definitions
├── app_client_adk.py         # Google ADK agent + CLI chat
├── app_client_langgraph.py   # LangGraph agent + ReAct CLI chat
├── mcp_config.json           # Example MCP tool config
├── requirements.txt          # Dependencies
└── README.md

---

🚀 はじめに

☑️ 前提条件

• Python 3.10+

⚙️ インストール

# Clone this repository
❯ git clone https://github.com/serkanyasr/mcp-agent-tool-adapter
❯ cd mcp-agent-tool-adapter

# Install dependencies
❯ 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 ツールは MCPClient を介してエージェントに接続されます。MCPClient は次の処理を担当します。

• ツールサーバーの起動（サブプロセス経由）
• セッション管理
• ツールの適応（langgraph または Google ADK）
• クリーンアップ

アプリで tool_type を "google" または "langgraph" に変更すると、エージェントの種類を動的に切り替えられます。

---

🧪 開発／コントリビューション

• リポジトリをフォークし、機能ブランチを作成します。
• 変更内容の説明を添えて PR を送信します。
• Issue または PR で @serkanyasr をメンションします。

次の分野でのコントリビューションを歓迎します。

• 🧩 新しい MCP ツールアダプター
• 🧠 マルチエージェントの LangGraph 活用事例
• 🛠️ OpenAPI／ストリーミングのサポート

---

🎗 ライセンス

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

---