UZCBU MCP Server

Ein Model Context Protocol (MCP) Server, der die offiziellen Wechselkurse der Zentralbank Usbekistans (CBU.uz) mit jedem MCP-kompatiblen KI-Assistenten (Claude Desktop, Claude Code usw.) verbindet.

MCP ist ein offener Standard, der in den Jahren 2024–2025 entstanden ist und sich bis 2026 in der KI-Welt weit verbreitet hat; er wird verwendet, um KI-Modelle mit externen Daten und Systemen zu verbinden. Dieses Projekt ist einer dieser Server für Usbekistan.

Was es kann

• get_all_rates — gibt die offiziellen Kurse aller Währungen von heute zurück

• get_exchange_rate — gibt den heutigen Kurs für eine einzelne Währung (z. B. USD) zurück

• get_historical_rate — gibt den Kurs für ein bestimmtes vergangenes Datum zurück

• convert_currency — konvertiert zwischen zwei Währungen zum offiziellen Kurs (z. B. berechnet, wie viele EUR 100 USD entsprechen)

Datenquelle: die offizielle offene JSON-API von cbu.uz. Es ist weder ein API-Schlüssel noch eine Registrierung erforderlich.

Related MCP server: Currency MCP Agent

Installation

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

Manuelles Starten (zum Testen)

python -m uzcbu_mcp.server

Der Server startet über den standardmäßigen MCP-stdio-Transport und wartet auf Anfragen von einem MCP-Client.

Verbinden mit Claude Desktop

Öffnen Sie die Konfigurationsdatei von Claude Desktop (claude_desktop_config.json) und fügen Sie Folgendes hinzu:

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

Starten Sie Claude Desktop neu. Wenn Sie Claude nun fragen: „Wie hoch ist der heutige Dollarkurs?“ oder „Rechne 100 Dollar in Euro um“, ruft er automatisch die Tools auf Ihrem Server auf.

Testen

Um die Logik ohne Netzwerkzugriff (mit Mock-Daten) zu überprüfen:

python test_offline.py

Projektstruktur

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

Warum dieses Projekt hervorsticht

Dies ist nicht nur ein „API-Wrapper“ – es basiert auf dem Model Context Protocol, dem neuen Standard des KI-Ökosystems, das heißt, jeder MCP-kompatible KI-Client (nicht nur ein einzelner Chatbot) kann es nutzen. MCP-Server, die mit Daten im usbekischen Kontext (offizielle Zentralbankkurse) arbeiten, gibt es derzeit nur sehr wenige.

Erweiterungsideen

• Weitere CBU-Statistikdaten (Inflation, Zinssätze) hinzufügen

• Ergebnisse durch Caching (für einige Minuten) beschleunigen

• Integration mit einem Telegram-Bot oder N8N-Workflow

• HTTP/SSE-Transport hinzufügen, um einen remote arbeitenden Server zu erstellen

Lizenz

MIT