mcp-agent-tool-adapter

<p align="center"> <h1 align="center">mcp-agent-tool-adapter</h1> </p> <p align="center"> <em>从协议到智能：使用 MCP 为 Agent 提供动力。</em> </p> <p align="center"> <img src="https://img.shields.io/github/license/serkanyasr/mcp-agent-tool-adapter?style=default&logo=opensourceinitiative&logoColor=white&color=0080ff" alt="license"> <img src="https://img.shields.io/github/last-commit/serkanyasr/mcp-agent-tool-adapter?style=default&logo=git&logoColor=white&color=0080ff" alt="last-commit"> <img src="https://img.shields.io/github/languages/top/serkanyasr/mcp-agent-tool-adapter?style=default&color=0080ff" alt="repo-top-language"> <img src="https://img.shields.io/github/languages/count/serkanyasr/mcp-agent-tool-adapter?style=default&color=0080ff" alt="repo-language-count"> </p>

---

📍 概述

MCP Agent Tool Adapter 允许通过 MCP 协议 进行模块化工具调用，并提供可以使用 Google ADK 或 LangGraph 动态推理工具的 Agent。

该项目将 MCP 工具转换为：

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

---

🧱 项目结构

mcp-agent-tool-adapter/
├── mcp_client/                # 核心客户端实现（模块化）
│   ├── client.py              # MCPClient & MCPServer
│   ├── tool_loader.py         # 高级异步加载器
│   └── types.py               # 共享类型定义
├── app_client_adk.py         # Google ADK Agent + CLI 聊天
├── app_client_langgraph.py   # LangGraph Agent + ReAct CLI 聊天
├── mcp_config.json           # 示例 MCP 工具配置
├── requirements.txt          # 依赖项
└── README.md

---

🚀 快速开始

☑️ 前提条件

• 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 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，MCPClient 处理：

• 工具服务器生成（通过子进程）
• 会话管理
• 工具适配（langgraph 或 Google ADK）
• 清理

您可以通过在您的应用程序中将 tool_type 更改为 "google" 或 "langgraph" 来动态切换 Agent 类型。

---

🧪 开发 / 贡献

• Fork 该仓库并创建特性分支。
• 提交一个 PR，其中包含对您所做更改的描述。
• 在 issue 或 PR 中标记 @serkanyasr。

我们欢迎以下方面的贡献：

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

---

🎗 许可证

本项目基于 MIT 许可证。有关更多详细信息，请参阅 LICENSE 文件。

---