Currency Exchange Service

為替レートサービス

リアルタイムの為替レートを提供し、対応している通貨を一覧表示する為替レートサービスです。

機能

• 対応している任意の2通貨間の現在の為替レートを取得します
• 対応しているすべての通貨を一覧表示します
• 簡単にデプロイできる Docker サポート
• SSE（Server-Sent Events）ベースの通信

前提条件

• Python 3.11 以降
• Docker（任意、コンテナ化してデプロイする場合）
• Git
• Exchange Rate API キー（https://www.exchangerate-api.com/ から取得してください）

インストール

Docker を使用する場合（推奨）

1. リポジトリをクローンします：

git clone <repository-url>
cd <repository-name>

2. プロジェクトのルートにある .env.example の手順に従って .env ファイルを作成します：

# Get your API key from https://www.exchangerate-api.com/
- `EXCHANGE_RATE_API_KEY`: Your Exchange Rate API key
- `GROQ_API_KEY`: Your GROQ API key

3. Docker コンテナをビルドして起動します：

docker compose up -d

Python を直接使用する場合

1. リポジトリをクローンします：

git clone <repository-url>
cd <repository-name>

2. プロジェクトのルートに .env ファイルを作成します：

# Get your API key from https://www.exchangerate-api.com/
EXCHANGE_RATE_API_KEY=your_api_key_here

3. 仮想環境を作成して有効化します：

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

4. 依存関係をインストールします：

pip install -r mcpserver/requirements.txt

使い方

Python クライアントを使用する場合

サービスを操作するには、クライアントスクリプトを実行します：

python mcpserver/client-sse.py

実行すると、次の処理が行われます：

• 利用可能なすべてのツールを一覧表示します
• 為替レートの例（INR から USD）を表示します
• 対応している通貨の一覧を表示します

API ドキュメント

このサービスでは、主に次の2つのツールを提供しています：

1. get_exchange_rate(from_currency, to_currency)

   • 2つの通貨間の現在の為替レートを返します
   • 例：USD から EUR への為替レートを取得します

2. list_supported_currencies()

   • 対応しているすべての通貨の一覧を返します
   • 通貨コードと名称が含まれます

開発

サービスを変更するには、次の手順に従います：

1. mcpserver/server.py を変更します
2. クライアントスクリプトを使用してテストします
3. Docker を使用している場合は、Docker コンテナを再ビルドします：

docker compose build --no-cache
docker compose up -d

API キーの取得

1. https://www.exchangerate-api.com/ にアクセスします
2. 無料アカウントに登録します
3. ダッシュボードから API キーを取得します
4. インストール手順に示されているように、.env ファイルに追加します