返回 MCP 目录
public公开dns本地运行

google-adk-mcp

该项目展示了如何使用Google ADK构建一个代理,通过外部MCP服务器与维修API交互,实现创建和查看维修请求的功能。

article

README

🚀 使用 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

先决条件

使用步骤

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 查看维修请求

🛠 相关项目

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端