ADK代理工具

简单的ADK代理，用于连接MCP服务器

这是一个用（某种工具/语言/框架等，原文中未具体说明）构建的简单代理 谷歌代理开发 套件 这个可以插入MCP服务器。那里 没有认证或安全措施。

这两个组件——Agent 和 MCP 服务器——被实现为两个常规应用程序， 用Python实现。它们都可以在本地运行。一个是代理，另一个是（接下来的内容根据上下文补充，例如）“环境/系统” 另一个是一个简单的MCP服务器，代理会连接到该服务器。

前提条件和设置

你需要Python3。并且需要使用TomTom、OpenSky和Gemini的凭据。

首次着手处理这件事：

1. 设置你的Python环境：

   复制

   python3 -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt
   

2. 创建一个 .env 文件，内容如下：

   复制

   TOMTOM_API_KEY=xxyyyzz
   OSKY_CLIENT_ID=email@example.com-api-client
   OSKY_CLIENT_SECRET=xxxyyyyzzhzhhdhd
   GOOGLE_API_KEY=aasssbbbbcccccddde-elekel
   

   您需要通过访问以下链接来获取这些服务的凭据：

   • https://developer.tomtom.com/ 翻译成中文是：https://developer.tomtom.com/（注：网址本身在中文语境下通常不翻译，保持原样，但“TomTom开发者平台”可以作为对网址内容的描述性翻译，不过在此直接给出网址的保持原样的翻译）。若仅需描述性翻译该网址所属内容，可译为“TomTom开发者平台”
   • https://opensky-network.org/ 翻译为中文是：“https://开放天空网络.org/”（注：实际网址翻译时通常保留原样，这里的翻译只是为了展示翻译思路，实际使用中应直接使用原网址）。不过，更自然的表达可能是直接说明这是一个网站，如：“这是开放天空网络的官方网站。”
   • https://ai.studio（该网址可直接翻译为“AI工作室”，但实际翻译时通常保留原网址形式，因为网址本身是专有名词，无需逐字翻译）

运行它

1. 首先启动MCP服务器。
   它将在本地主机（localhost）的9240端口上监听

   复制

   dotenv run python3 mcp-server/main.py 
   

2. 以网页应用的形式（再次，在本地）运行代理，并配备用户界面

   复制

   dotenv run adk web -v  ./agent/agents
   

   然后在本地浏览器中访问 http://localhost:8000。

然后，您可以与代理进行交互。向它提出诸如以下问题：

• 告诉我北卡罗来纳州夏洛特周边当前的空中交通情况；具体来说，关于 那里的航空公司航班最多， 以及有多少个航班 这些航空公司 有吗？同时也要包括没有注册呼号的航班数量，或者 无法解析为航空公司的呼号。将结果格式化为 表格，并在表格的最后一行给出飞行次数的总计。

• 比较目前观察到的芝加哥和西雅图的飞机飞行活动情况， 此刻的夏洛特和达拉斯。

为读者而写

• 你可以将其中一个、两个都部署到Cloud Run上。如果你这样做，你需要 在代理代码中修改MCP端点。

• 你可以在代理（Agent）中插入逻辑，以使用访问令牌连接到MCP服务器

免责声明

这个示例既不是谷歌的官方产品，也不属于任何 谷歌官方产品。

支持

这个调用是开源软件，并非Apigee的支持部分。如果 你需要帮助的话，可以尝试询问 谷歌云 社区 论坛。没有服务级别（的限制/要求） 保证对该网站上发布的查询作出回应。

许可证

这种材料是 版权所有 © 2025 Google LLC。 并已获得以下许可 Apache 2.0 许可证。