关于 google-adk-mcp
google-adk-mcp 是一个示例项目,展示如何用 Google ADK 构建 Agent,并连接 repair_world_application 的 MCP 服务。它面向学习 ADK 与 MCP 协作的开发者,提供网页界面和命令行两种运行方式。
主要功能
- 01使用 Google ADK 构建 Agent
- 02连接 repairworld MCP 服务
- 03创建维修请求
- 04列出维修请求
- 05按 ID 查看维修请求
- 06提供网页和控制台界面
适用场景
- 01学习 Agent 调用外部 MCP 工具
- 02通过 Agent 创建维修请求
- 03在网页或控制台查看请求列表与详情
MCP 相关
项目中的 Agent 连接 mcp-server-repairworld,并调用其提供的维修请求创建、列表和按 ID 查看工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
google-adk-mcp
🚀 示例项目,演示如何构建一个使用外部 MCP 服务与维修 API 交互的 Google ADK Agent(repairworld application — 专为本演示创建)。
此 Agent 配合博客文章和演示推出:26. 最简单的 MCP 演示(包含示例提供方应用、MCP 服务以及 Agent 🤖 代码和说明!)
🧠 本项目的功能
本项目演示如何:
- ✅ 使用 Google ADK(Agent Developer Kit) 构建 Agent。
- 🔌 将该 Agent 连接到现有的 MCP 服务,以使用其提供的
repair_world_application功能(例如,创建和查看维修请求)。
该 Agent 使用来自 PyPI 仓库的 MCP 服务 — mcp-server-repairworld。
📦 前提条件
- Python 3.11+
- 正在运行的 repairworld application。
🚀 使用方法
1. 克隆此仓库并创建 Python 虚拟环境
git clone https://github.com/your-username/google-adk-mcp.git
cd google-adk-mcp
# create python virtual environment
python -m venv .venv
. .venv/bin/activate # on windows do .venv\Scripts\activate
2. 安装依赖项
pip install -r requirements.txt
3. 运行 Agent(Agent Web 界面)
确保 repairworld application 已经在运行。
访问 http://localhost:8000 以打开 Agent UI
adk web
或
3. 运行 Agent(Agent 控制台界面)
确保 repairworld application 已经在运行。
python agent-repairworld.py
现在,Agent 应该能够调用 MCP 服务提供的工具,以执行以下操作:
🔧 创建维修请求
📄 列出所有维修请求
🔍 按 ID 查看维修请求
🛠 相关项目
- mcp-server-repairworld — 提供用于与 repair_world_application 交互的工具的 MCP 服务。
- repair_world_application - 允许客户创建维修请求的应用
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。