AI导哈

MCP代理工具

展示MCP模式的ADK代理工具，支持直接调用和代码模式两种代理方式，适用于自动化任务处理。

  • by yai333
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 yai333/ADK-MCP-Agents

使用说明

ADK MCP代理

两个ADK代理以代码模式演示MCP模式。

快速开始

uv sync

cp .env.example .env

# Run all examples
uv run python example.py

./test.sh direct   # Test direct agent
./test.sh code     # Test code mode agent


# Or run tests directly (includes verbose warnings)
uv run python test_direct_agent.py
uv run python test_code_mode_agent.py

两名特工

1.直接代理人

传统的MCP工具调用-代理直接调用工具。

from adk_mcp_agent.direct_agent import direct_agent
from google.adk.runners import Runner

runner = Runner(agent=direct_agent)
response = runner.run("Calculate 5 + 3")

2.代码模式代理

Cloudflare代码模式模式代理生成使用工具执行的Python代码。

from adk_mcp_agent.code_mode_agent import code_mode_agent
from google.adk.runners import Runner

runner = Runner(agent=code_mode_agent)
response = runner.run("Calculate sum of squares from 1 to 10")

MCP服务器示例

配置于 mcp_config.py:

  • 计算器 （自定义）-使用FastMCP的算术运算
  • 文件系统 （预构建）-/tmp中的文件操作
  • pdf （预构建）-PDF文本提取

添加自定义MCP服务器

  1. 在中创建服务器 servers/your_server/mcp_server.py:
from fastmcp import FastMCP

mcp = FastMCP(name="your_server")

@mcp.tool
async def your_tool(param: str) -> dict:
    return {"result": param}

if __name__ == "__main__":
    mcp.run()
  1. 增添 mcp_config.py:
"your_server": {
    "command": "python",
    "args": ["-m", "adk_mcp_agent.servers.your_server.mcp_server"],
    "env": {"PYTHONPATH": AGENT_DIR}
}

已知问题

架构兼容性问题

问题

一些预构建的MCP服务器使用 元组验证 在他们的JSON模式中，这是有效的JSON模式，但大多数LLM提供商不支持：

"items": [{"type": "number"}, {"type": "number"}]  // 2-element tuple

这会导致Google ADK/Gemini崩溃：

AttributeError: 'list' object has no attribute 'items'

跨提供商兼容性

元组验证在很大程度上不受支持：

  • 谷歌双子座：架构转换器中的运行时崩溃

相关 MCP