google-adk-mcp

🚀 使用 Google ADK MCP 的示例项目

本项目演示了如何构建一个 Google ADK 代理人，该代理人可借助外部 MCP 服务器与修复世界应用 API（repair_world_application - 专为演示创建）进行交互。此项目与博客文章及演示配套使用，详情可查看 26. 最简单的 MCP 演示（包括示例提供程序应用、MCP 服务器和代理 🤖 代码和说明！)。

🚀 快速开始

项目功能

该项目展示了以下操作方法：

1. ✅ 运用 Google ADK (开发者工具包) 构建一个代理人。
2. 🔌 将该代理人连接至现有的 MCP 服务器，以使用 repair_world_application 的功能（例如创建和查看维修请求）。此代理人使用来自 PyPI 仓库的 MCP 服务器 - mcp-server-repairworld。

先决条件

• Python 3.11+
• 运行中的 repair_world_application。

使用步骤

1. 克隆此仓库并创建 Python 虚拟环境

git clone https://github.com/your-username/google-adk-mcp.git
cd google-adk-mcp

# 创建 Python 虚拟环境
python -m venv .venv
. .venv/bin/activate # Windows 用户请运行 .venv\Scripts\activate

2. 安装依赖项

pip install -r requirements.txt

3. 运行代理（代理 Web 界面）

确保 repair_world_application 已经运行。访问 http://localhost:8000 来获取代理 UI。

adk web

或 3. 运行代理（代理控制台界面）

确保 repair_world_application 已经运行。

python agent-repairworld.py

此时，代理应能够调用 MCP 服务器暴露的工具来：

• 🔧 创建维修请求
• 📄 列出所有维修请求
• 🔍 按 ID 查看维修请求

🛠 相关项目

• mcp-server-repairworld — 曝露与 repair_world_application 交互工具的 MCP 服务器。
• repair_world_application - 允许客户创建维修请求的应用程序