A2a Adk MCP Example

🚀 Google ADK、A2Aプロトコル、MCPを統合したAIエージェントプロジェクト

このプロジェクトは、Google ADK（Agent Development Kit）を統合したAIエージェントの実装です。A2A（Agent-to-Agent）プロトコルをサポートして他のエージェントとの相互作用を可能にし、MCP（Model Context Protocol）サーバーを介して拡張可能です。このプロジェクトには、AIエージェントの開発、テスト、デプロイに必要なインフラストラクチャが含まれており、モニタリングとトレーシング機能も備えています。

A2Aプロトコルの詳細なドキュメント: ドキュメント と Postmanコレクション

✨ 主な機能

• Google ADK統合 - エージェント開発に最適な先進的なSDKを使用
• MCPツールサポート - Model Context Protocolとの統合による拡張可能なツールの利用
• 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

🔧 設定

環境ファイルの作成

# サンプルから.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"

💻 使用例

エージェントの起動

# 主要なサービスの起動
make up

# エージェントは http://localhost:10002 でアクセス可能

開発モード

# ライブリロード付きの開発モードで起動
make dev

# デバッグ用のPhoenixモニタリング付きで起動
make dev-phoenix

状態の確認

# すべてのサービスのステータス
make status

# ヘルスチェック
make health

# ログの表示
make logs

📚 詳細ドキュメント

エージェント (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ドキュメント
• Model Context Protocol
• LiteLLMドキュメント
• Phoenixトレーシング

📁 プロジェクト構造

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              # 無視するファイル