Langgraph MCP Agents

🚀 📍 MCP Agent Tool Adapter

MCP Agent Tool Adapter は MCP プロトコル を通じてツールのモジュール化呼び出しを実現し、Google ADK または LangGraph を使用した動的推論を行うエージェントを提供します。

このプロジェクトは MCP ツールを以下のように変換します：

• 🤖 Google ADK ベースのエージェントで、ストリーミング FastAPI または CLI インターフェース付き
• 🧠 LangGraph ベースのエージェントで、ReAct + ストリーミングツール計画を使用

🚀 クイックスタート

☑️ 前提条件

• Python 3.10+

⚙️ インストール

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

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

✨ 主な機能

• MCP ツールを Google ADK または LangGraph ベースのエージェントに変換します。
• ストリーミング FastAPI または CLI インターフェースを提供します。
• ReAct + ストリーミングツール計画を使用した LangGraph ベースのエージェントをサポートします。

📦 インストール

# このリポジトリをクローンする
❯ 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 を介してエージェントに接続し、以下を処理します：

• ツールサーバー.spawn（子プロセス経由）
• セッション管理
• ツール適応（langgraph または Google ADK）
• クリーンアップ作業

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

🔧 技術詳細

MCP ツールは MCPClient を通じてエージェントに接続され、ツールサーバーの起動、セッション管理、ツールの適応、クリーンアップ作業などを行います。エージェントのタイプは tool_type を変更することで動的に切り替えることができ、Google ADK または LangGraph を使用した動的推論を行うことができます。

📄 ライセンス

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