简单的ADK代理,用于连接MCP服务器
这是一个用(某种工具/语言/框架等,原文中未具体说明)构建的简单代理 谷歌代理开发 套件 这个可以插入MCP服务器。那里 没有认证或安全措施。
这两个组件——Agent 和 MCP 服务器——被实现为两个常规应用程序, 用Python实现。它们都可以在本地运行。一个是代理,另一个是(接下来的内容根据上下文补充,例如)“环境/系统” 另一个是一个简单的MCP服务器,代理会连接到该服务器。
前提条件和设置
你需要Python3。并且需要使用TomTom、OpenSky和Gemini的凭据。
首次着手处理这件事:
- 设置你的Python环境:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt- 创建一个 .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工作室”,但实际翻译时通常保留原网址形式,因为网址本身是专有名词,无需逐字翻译)
运行它
- 首先启动MCP服务器。\
它将在本地主机(localhost)的9240端口上监听
dotenv run python3 mcp-server/main.py - 以网页应用的形式(再次,在本地)运行代理,并配备用户界面
dotenv run adk web -v ./agent/agents然后在本地浏览器中访问 http://localhost:8000。
然后,您可以与代理进行交互。向它提出诸如以下问题:
- 告诉我北卡罗来纳州夏洛特周边当前的空中交通情况;具体来说,关于
那里的航空公司航班最多, _以及有多少个航班_ 这些航空公司 有吗?同时也要包括没有注册呼号的航班数量,或者 无法解析为航空公司的呼号。将结果格式化为 表格,并在表格的最后一行给出飞行次数的总计。
- 比较目前观察到的芝加哥和西雅图的飞机飞行活动情况,
此刻的夏洛特和达拉斯。
为读者而写
- 你可以将其中一个、两个都部署到Cloud Run上。如果你这样做,你需要
在代理代码中修改MCP端点。
- 你可以在代理(Agent)中插入逻辑,以使用访问令牌连接到MCP服务器
免责声明
这个示例既不是谷歌的官方产品,也不属于任何 谷歌官方产品。
支持
这个调用是开源软件,并非Apigee的支持部分。如果 你需要帮助的话,可以尝试询问 谷歌云 社区 论坛。没有服务级别(的限制/要求) 保证对该网站上发布的查询作出回应。
许可证
这种材料是 版权所有 © 2025 Google LLC。 并已获得以下许可 Apache 2.0 许可证。
