mcp-cbr-rates

ロシア中央銀行（Центральный банк РФ, CBR）の公開データ（為替レート、政策金利、インフレ率、およびコンパクトなマクロ統計スナップショット）をAIエージェントに提供するModel Context Protocol (MCP) サーバー。

mcp-cbr-rates は、ロシアのフィンテックエコシステムに焦点を当てた atomno ファミリーのMCPサーバーの一部です。完全にオープンソースであり、APIキーは不要で、CBRの公式公開エンドポイントに基づいて構築されています。

特徴

• 厳格なPydanticスキーマを備えた5つの高品質なMCPツール: get_rate, history_rates, key_rate, inflation, statistics。

• 内蔵TTL（Time-To-Live）キャッシュ: ソースへの負荷を考慮し、日次レートは1時間、過去の時系列データは24時間キャッシュします。

• 5xxエラー時の自動リトライ機能を備えた非同期 httpx トランスポート。

• defusedxml による安全なXML解析。

• respx でモックされたHTTPテストを含む50以上のユニットテスト、80%以上のカバレッジ。

• シークレット、テレメトリ、サードパーティのトラッカーは一切なし。

Related MCP server: ozon-mcp

クイックスタート

ソースからインストール

git clone https://github.com/atomno-labs/mcp-cbr-rates.git
cd mcp-cbr-rates
pip install -e .
mcp-cbr-rates  # starts the MCP server over stdio

Cursorでの使用

.cursor/mcp.json（またはグローバルな ~/.cursor/mcp.json）に以下を追加します：

{
  "mcpServers": {
    "cbr-rates": {
      "command": "mcp-cbr-rates"
    }
  }
}

Claude Desktopでの使用

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "cbr-rates": {
      "command": "mcp-cbr-rates"
    }
  }
}

Windowsの場合、設定ファイルは %APPDATA%\Claude\claude_desktop_config.json にあり、macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json にあります。

Claude Codeでの使用

claude mcp add cbr-rates -- mcp-cbr-rates

ツール

平易な英語での例：

"2024年4月25日の公式EURレートはいくらでしたか？" ツール: get_rate(char_code="EUR", on_date="2024-04-25")

"過去90日間のUSD-RUBの日次レートをプロットして。" ツール: history_rates(char_code="USD", date_from=..., date_to=...)

"最新の政策金利、USD/EUR/CNY、インフレ率を一度に教えて。" ツール: statistics()

history_rates の期間は最大366日に制限されています。それ以上の期間が必要な場合は、ツールを繰り返し呼び出してください。

設定

すべての設定はオプションであり、環境変数から読み込まれます：

設定すべきAPIキーはありません。ここで使用されるすべてのCBRエンドポイントは公開されています。

開発

git clone https://github.com/atomno-labs/mcp-cbr-rates.git
cd mcp-cbr-rates
python -m venv .venv && source .venv/bin/activate  # or .\.venv\Scripts\activate on Windows
pip install -e ".[dev]"
pytest --cov=src/mcp_cbr_rates

レイアウト:

apps/mcp-cbr-rates/
├── src/mcp_cbr_rates/
│   ├── server.py        # FastMCP entry point, tool registration
│   ├── tools.py         # high-level async tools with caching
│   ├── client.py        # httpx wrapper around CBR XML / SOAP / HTML endpoints
│   ├── schemas.py       # Pydantic v2 models for inputs & outputs
│   ├── cache.py         # async TTL cache
│   ├── currency_codes.py # static ISO → CBR id map (with dynamic fallback)
│   └── errors.py        # typed exception hierarchy
└── tests/               # respx-mocked unit tests + fixtures

データソース

• https://www.cbr.ru/scripts/XML_daily.asp — 日次為替レート。

• https://www.cbr.ru/scripts/XML_dynamic.asp — 過去の為替時系列データ。

• https://www.cbr.ru/scripts/XML_valFull.asp — 通貨コード検索。

• https://www.cbr.ru/DailyInfoWebServ/DailyInfo.asmx — CBR政策金利用SOAPサービス。

• https://www.cbr.ru/hd_base/infl/ — 月次前年同月比インフレ率テーブル。

すべてのエンドポイントは読み取り専用で無料です。

免責事項

このプロジェクトは、ロシア中央銀行とは一切関係ありません。公開されているデータを最大限の努力でラップした非公式なものです。自己責任でご利用ください。作成者は、本サーバーを通じて提供されるデータの鮮度、正確性、または適用性について一切の責任を負いません。

CBRのHTMLまたはXMLスキーマが変更された場合、このパッケージが更新されるまで個々のツールが動作しなくなる可能性があります。回帰を確認した場合は、Issueを作成してください。

ライセンス

MIT — LICENSE を参照してください。