A2a Adk MCP Example

🚀 集成Google ADK、A2A協議和MCP的AI代理項目

本項目實現了一個集成Google ADK（代理開發工具包）的AI代理，支持A2A（代理到代理）協議以與其他代理進行交互，並可通過MCP（模型上下文協議）服務器進行擴展。該項目包含了用於開發、測試和部署AI代理的完整基礎設施，具備監控和追蹤功能。

A2A協議的詳細文檔：文檔 和 Postman集合

✨ 主要特性

• 集成Google ADK：使用先進的代理開發SDK。
• 支持MCP工具：與模型上下文協議集成，實現可擴展工具。
• LiteLLM支持：通過統一接口支持多種大語言模型（LLM）。
• Phoenix監控：可選的執行監控和追蹤。
• Docker就緒：完全容器化，自動配置。
• A2A協議：實現代理到代理的通信。
• 靈活配置：通過環境變量進行配置。

📦 安裝指南

使用Docker快速啟動（推薦）

# 構建鏡像
make build

# 啟動主要服務
make up

# 代理將在 http://localhost:10002 可用
# MCP服務器將在 http://localhost:8001 可用

使用Makefile

# 查看所有可用命令
make help

# 啟動主要服務
make up

# 啟動並開啟Phoenix監控
make phoenix

# 開發模式
make dev

# 查看日誌
make logs

# 停止所有服務
make down

💻 使用示例

啟動代理

# 啟動主要服務
make up

# 代理將在 http://localhost:10002 可用

開發模式

# 以即時重載模式啟動開發
make dev

# 啟動並開啟Phoenix監控進行調試
make dev-phoenix

檢查狀態

# 查看所有服務狀態
make status

# 檢查健康狀況
make health

# 查看日誌
make logs

📚 詳細文檔

項目結構

a2a-adk-mcp-example/
├── agent/                  # 代理目錄
│   ├── app/                # 應用主代碼
│   │   ├── __main__.py     # Click CLI入口點
│   │   ├── agent.py        # AgentEvolution類
│   │   └── agent_executor.py  # 代理執行器
│   ├── .env.example        # 配置文件示例
│   ├── pyproject.toml      # 項目配置和依賴
│   └── README.md           # 代理文檔
├── mcp-weather/            # MCP天氣服務器
│   ├── server.py           # 主服務器
│   ├── Dockerfile          # Docker配置
│   └── README.md           # MCP服務器文檔
├── nginx/                  # Nginx配置
├── docker-compose.phoenix.yml  # 包含Phoenix的配置
├── docker-compose.yml      # Docker Compose主配置
├── Makefile                # 命令自動化
└── .gitignore              # 忽略文件

配置

創建環境文件

# 從示例創建.env文件
make env

# 或者手動創建
cp agent/.env.example .env

主要環境變量

在 .env 文件中可以配置以下參數：

# 代理主要設置
AGENT_NAME=jira_mcp_agent
AGENT_DESCRIPTION="Jira MCP代理，用於管理項目、任務、衝刺和敏捷流程"
AGENT_VERSION=1.0.0

# 模型配置
LLM_MODEL="evolution_inference/model-for-agent-space-test"
LLM_API_BASE="https://your-model-api-base-url/v1"

# MCP配置
MCP_URL=http://mcp-weather:8001/sse

# Phoenix監控（可選）
PHOENIX_PROJECT_NAME="ip_agent_adk"
PHOENIX_ENDPOINT="http://phoenix:6006/v1/traces"

# 服務器設置
HOST="0.0.0.0"
PORT="10002"

# 監控
ENABLE_PHOENIX="false"
ENABLE_MONITORING="true"

項目組件

代理 (agent/)

項目的主要組件是基於Google ADK的AI代理，支持MCP工具。該代理實現了A2A協議以與其他代理進行交互。

API端點

• GET / - 代理信息（代理卡片）
• POST /tasks - 創建新任務
• GET /tasks/{task_id} - 獲取任務狀態
• GET /tasks/{task_id}/stream - 任務執行的SSE流

MCP天氣服務器 (mcp-weather/)

該服務器通過MCP協議提供獲取天氣數據的工具，使用免費的Open-Meteo API。

工具

• get_today_weather(city: str) - 獲取指定城市的今日即時天氣
• get_weekly_forecast(city: str) - 獲取指定城市的一周天氣預報

端點

• SSE：http://localhost:8001/sse
• 消息：http://localhost:8001/messages/

監控

Phoenix追蹤

要啟用Phoenix監控，請設置環境變量：

ENABLE_PHOENIX=true

啟動並開啟Phoenix監控：

make phoenix

Phoenix儀表板將在 http://localhost:6006 可用。

Docker命令

# 主要命令
make build          # 構建鏡像
make up            # 啟動服務
make down          # 停止服務
make restart       # 重啟服務
make logs          # 查看日誌

# Phoenix監控
make phoenix       # 啟動並開啟監控
make phoenix-down  # 停止Phoenix監控

# 實用工具
make shell         # 進入代理容器
make clean         # 清理Docker資源

要求

• Docker：用於容器化
• Make：用於命令自動化
• MCP服務器：用於工具（可選）

📄 許可證

本項目採用MIT許可證分發。詳情請參閱 LICENSE 文件（如果有）。

🔗 有用鏈接

• Google ADK文檔
• 模型上下文協議
• LiteLLM文檔
• Phoenix追蹤