🚀 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 文件。