mcp-agent-tool-adapter

mcp-agent-tool-adapter

从协议到智能：借助 MCP 为 Agent 赋能。

---

📍 概述

MCP Agent Tool Adapter 支持通过 MCP protocol 模块化调用工具，并提供可使用 Google ADK 或 LangGraph 动态推理并使用工具的 Agent。

本项目可将 MCP 工具转换为：

• 🤖 基于 Google ADK 的 Agent，提供流式 FastAPI 或 CLI 接口
• 🧠 基于 LangGraph 的 Agent，使用 ReAct + 流式工具规划

---

🧱 项目结构

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 Agent：

❯ python app_client_adk.py

运行 LangGraph ReAct CLI Agent：

❯ python app_client_langgraph.py

确保你的 mcp_config.json 定义了如下工具：

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

---

🧠 工具架构

MCP 工具通过 MCPClient 连接到 Agent，它负责：

• 启动工具服务（通过 subprocess）
• 会话管理
• 工具适配（langgraph 或 Google ADK）
• 清理

你可以在应用中将 tool_type 改为 "google" 或 "langgraph"，以动态切换 Agent 类型。

---

🧪 开发 / 贡献

• Fork 此仓库并创建功能分支。
• 提交 PR，并说明所做的更改。
• 在 issue 或 PR 中 @serkanyasr。

欢迎以下方面的贡献：

• 🧩 新的 MCP 工具适配器
• 🧠 多 Agent LangGraph 用例
• 🛠️ OpenAPI / 流式支持

---

🎗 许可证

本项目采用 MIT License。更多详情请参阅 LICENSE 文件。

---