mcp-cbr-rates

Ein Model Context Protocol (MCP)-Server, der öffentliche Daten der Bank von Russland (Центральный банк РФ, CBR) — Währungskurse, Leitzins, Inflation und eine kompakte Makro-Übersicht — für KI-Agenten bereitstellt.

mcp-cbr-rates ist Teil der atomno-Familie von MCP-Servern, die sich auf das russische Fintech-Ökosystem konzentrieren. Es ist vollständig Open-Source, erfordert keine API-Schlüssel und basiert auf den offiziellen öffentlichen CBR-Endpunkten.

Funktionen

• Fünf hochwertige MCP-Tools, jedes mit einem strikten Pydantic-Schema: get_rate, history_rates, key_rate, inflation, statistics.

• Integrierter TTL-Cache (Time-To-Live): 1 Stunde für tägliche Kurse, 24 Stunden für historische Reihen, um die Quelle zu schonen.

• Asynchroner httpx-Transport mit automatischen Wiederholungsversuchen bei 5xx-Fehlern.

• Sicheres XML-Parsing via defusedxml.

• 50+ Unit-Tests mit respx-gemocktem HTTP, ≥80 % Abdeckung.

• Keine Geheimnisse, keine Telemetrie, keine Tracker von Drittanbietern.

Related MCP server: ozon-mcp

Schnellstart

Installation aus dem Quellcode

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

Verwendung mit Cursor

Fügen Sie Folgendes zu .cursor/mcp.json (oder Ihrer globalen ~/.cursor/mcp.json) hinzu:

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

Verwendung mit Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

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

Unter Windows befindet sich die Konfigurationsdatei unter %APPDATA%\Claude\claude_desktop_config.json; unter macOS unter ~/Library/Application Support/Claude/claude_desktop_config.json.

Verwendung mit Claude Code

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

Tools

Beispiele in einfachem Englisch:

"Wie war der offizielle EUR-Kurs am 25. April 2024?" Tool: get_rate(char_code="EUR", on_date="2024-04-25")

"Erstelle ein Diagramm des täglichen USD-RUB-Kurses über die letzten 90 Tage." Tool: history_rates(char_code="USD", date_from=..., date_to=...)

"Gib mir den aktuellen Leitzins, USD/EUR/CNY und die Inflation auf einmal." Tool: statistics()

Das history_rates-Fenster ist auf 366 Tage begrenzt; für längere Zeiträume rufen Sie das Tool wiederholt auf.

Konfiguration

Alle Einstellungen sind optional und werden aus Umgebungsvariablen gelesen:

Es gibt keine API-Schlüssel zu konfigurieren — alle hier verwendeten CBR-Endpunkte sind öffentlich.

Entwicklung

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

Layout:

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

Datenquellen

• https://www.cbr.ru/scripts/XML_daily.asp — tägliche Währungskurse.

• https://www.cbr.ru/scripts/XML_dynamic.asp — historische Währungsreihen.

• https://www.cbr.ru/scripts/XML_valFull.asp — Währungscode-Suche.

• https://www.cbr.ru/DailyInfoWebServ/DailyInfo.asmx — SOAP-Dienst für den CBR-Leitzins.

• https://www.cbr.ru/hd_base/infl/ — monatliche Inflationstabelle im Jahresvergleich.

Alle Endpunkte sind schreibgeschützt und kostenlos.

Haftungsausschluss

Dieses Projekt ist in keiner Weise mit der Bank von Russland verbunden. Es ist ein inoffizieller Wrapper für öffentlich verfügbare Daten, der nach bestem Wissen und Gewissen erstellt wurde. Die Nutzung erfolgt auf eigene Gefahr; die Autoren lehnen jegliche Verantwortung für die Aktualität, Richtigkeit oder Anwendbarkeit der über diesen Server bereitgestellten Daten ab.

Sollten sich die HTML- oder XML-Schemata der CBR ändern, funktionieren einzelne Tools möglicherweise nicht mehr, bis dieses Paket aktualisiert wird. Bitte öffnen Sie ein Issue, wenn Sie eine Regression bemerken.

Lizenz

MIT — siehe LICENSE.