# 為替変動分析 AI エージェント（ADK + MCP デモ）

## 概要

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キー不要）        │
└──────────────────────────────────────────────────┘
```

## セットアップ

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

## ローカルテスト

```bash
# ADK Web UI
adk web forex_agent

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

## デプロイ

```bash
# 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` をデプロイ出力のリソース名に変更し、実行：

```bash
python test_remote_agent.py
```