Skip to main content

功能说明

使用 Google ADK 的 McpToolset 连接 MCP Server,将返回的工具集放入 Agent(tools=[toolset])。旧名称 MCPToolset 保留兼容。远端服务需提供支持的 MCP 地址与凭证;本地服务需有可执行命令及其依赖

使用方法

先设置 MCP_SERVER_URL 与 MCP_SERVER_TOKEN,再运行以下示例验证工具发现。仅列出工具不需要推理模型,注册到智能体并调用时还需完成模型配置
mcp_connection.py

本地标准输入输出连接

将以下两个文件保存到同一目录,安装 python -m pip install "mcp[cli]",然后运行 python check_local_mcp.py。预期输出包含 add;服务器由客户端启动,示例结束后关闭
local_mcp_server.py
check_local_mcp.py

参数

以下构造参数对应 Google ADK 2.2.0;使用其他版本时以安装版本支持的参数为准 Streamable HTTP 连接使用 url(必填)、headers=None、timeout=5.0、sse_read_timeout=300.0、terminate_on_close=True,时间单位为秒。httpx_client_factory 默认使用 SDK 的 HTTP 客户端工厂,仅需自定义传输时覆盖。本地连接使用 StdioConnectionParams(server_params=..., timeout=5.0);SSE 服务使用 SseConnectionParams,不要把 SSE 与 Streamable HTTP 地址混用

会话中断后的自动重连

VeADK 在连接失效后重新建立 MCP 会话,并对符合重连条件的工具加载或调用重试一次;再次失败时向调用方返回错误,主动取消不会触发重试。会产生外部变更的工具仍需由服务提供幂等保障,连接重试不等同于业务操作只执行一次
最后修改于 2026年9月19日