UZCBU MCP Server

ウズベキスタン中央銀行（CBU.uz）の公式為替レートを、任意のMCP対応AIアシスタント（Claude Desktop、Claude Codeなど）に接続する**Model Context Protocol (MCP)**サーバーです。

MCPは、2024年から2025年にかけて登場し、2026年までにAIの世界で広く普及しつつあるオープン標準であり、AIモデルを外部データやシステムに接続するために使用されます。このプロジェクトは、ウズベキスタン向けのそのようなサーバーの1つです。

できること

• get_all_rates — 今日の全通貨の公式レートを返します

• get_exchange_rate — 1つの通貨（例：USD）の今日のレートを返します

• get_historical_rate — 特定の過去の日付のレートを返します

• convert_currency — 2つの通貨間で公式レートに基づいて換算します（例：100 USDが何EURになるかを計算します）

データソース: cbu.uz 公式オープンJSON API。APIキーや登録は不要です。

Related MCP server: Realtime Exchange Rate MCP Server

インストール

git clone https://github.com/<sizning-username>/uzcbu-mcp-server.git
cd uzcbu-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

手動起動（テスト用）

python -m uzcbu_mcp.server

サーバーは標準のMCP stdioトランスポートを介して起動し、MCPクライアントからのリクエストを待ちます。

Claude Desktopへの接続

Claude Desktopの設定ファイル（claude_desktop_config.json）を開き、以下を追加します：

{
  "mcpServers": {
    "uzcbu-currency": {
      "command": "python",
      "args": ["-m", "uzcbu_mcp.server"],
      "cwd": "/to'liq/yo'l/uzcbu-mcp-server"
    }
  }
}

Claude Desktopを再起動します。これで、Claudeに「今日のドルレートは？」や「100ドルをユーロに換算して」と尋ねると、サーバー上のツールを自動的に呼び出します。

テスト

ネットワークに接続せず（モックデータで）ロジックを確認するには：

python test_offline.py

プロジェクト構成

uzcbu-mcp-server/
├── uzcbu_mcp/
│   ├── __init__.py
│   └── server.py          # MCP server va barcha tool'lar
├── test_offline.py        # Mock ma'lumot bilan offline testlar
├── requirements.txt
├── pyproject.toml
└── README.md

このプロジェクトの特徴

これは単なる「APIラッパー」ではありません。AIエコシステムの新しい標準であるModel Context Protocolに基づいて構築されており、任意のMCP対応AIクライアント（単一のチャットボットだけでなく）が利用できます。ウズベキスタンの文脈のデータ（公式中央銀行レート）を扱うMCPサーバーは、現時点では非常に少ないです。

拡張アイデア

• 他のCBU統計データ（インフレ率、金利）を追加

• 結果をキャッシュ（数分）して高速化

• TelegramボットやN8Nワークフローとの統合

• HTTP/SSEトランスポートを追加して、リモートで動作するサーバーにする

ライセンス

MIT