Langgraph MCP Agents

🚀 MCP Agent Tool Adapter

MCP Agent Tool Adapter 通過 MCP 協議 實現工具的模塊化調用，並提供使用 Google ADK 或 LangGraph 進行動態推理的代理。該項目能夠將 MCP 工具轉換為不同類型的代理，為開發者提供多樣化的使用方式。

🚀 快速開始

☑️ 先決條件

• 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 的代理，帶有流式 FastAPI 或 CLI 接口
• 🧠 基於 LangGraph 的代理，使用 ReAct + 流式工具計劃

📦 項目結構

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

💻 使用示例

基礎用法

運行 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 連接到代理，處理以下內容：

• 工具服務器.spawn（通過子進程）
• 會話管理
• 工具適應（langgraph 或 Google ADK）
• 清理工作

你可以通過更改 tool_type 為 "google" 或 "langgraph" 來動態切換代理類型。

🧪 開發 / 貢獻

• 分叉倉庫並創建功能分支。
• 提交一個帶有變更描述的 PR。
• 在問題或 PR 中@serkanyasr。

我們歡迎以下方面的貢獻：

• 🧩 新的 MCP 工具適配器
• 🧠 多代理 LangGraph 使用情況
• 🛠️ OpenAPI / 流式支持

📄 許可證

該項目在 MIT License 下授權。有關詳細信息，請參閱 LICENSE 文件。