Frankfurter Currency Exchange

概要

Google Agent Development Kit (ADK) と Model Context Protocol (MCP) の連携を実演するデモプロジェクトです。

日本円（JPY）対 米ドル（USD）・人民元（CNY）・ユーロ（EUR）の為替レートを MCP Server 経由で取得し、Gemini 2.5-Flash が変動分析レポートを日本語で生成します。

アーキテクチャ

Vertex AI Agent Engine
┌──────────────────────────────────────────────────┐
│                                                  │
│  ADK Agent（Gemini 2.5-Flash）                    │
│  為替変動分析エージェント                          │
│       │ stdio                                    │
│       ▼                                          │
│  MCP Server（FastMCP / Python）                   │
│  ├─ get_jpy_latest_rates   最新レート取得         │
│  ├─ get_jpy_rate_history   期間変動推移取得       │
│  └─ convert_jpy            金額換算              │
│       │ HTTPS                                    │
│       ▼                                          │
│  Frankfurter API（外部・無料・APIキー不要）        │
└──────────────────────────────────────────────────┘

セットアップ

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

ローカルテスト

# ADK Web UI
adk web forex_agent

# ブラウザで http://localhost:8000 を開く

デプロイ

# GCP 認証
gcloud auth login
gcloud auth application-default login
gcloud config set project dsk-agentspace-trial

# GCS バケット作成（初回のみ）
gcloud storage buckets create gs://forex-mcp-agent-staging \
  --project=dsk-agentspace-trial \
  --location=us-central1

# デプロイ
python deploy.py

デプロイ後の動作確認

test_remote_agent.py 内の RESOURCE_NAME をデプロイ出力のリソース名に変更し、実行：

python test_remote_agent.py