UZCBU MCP Server

Servidor Model Context Protocol (MCP) que conecta los tipos de cambio oficiales del Banco Central de Uzbekistán (CBU.uz) a cualquier asistente de IA compatible con MCP (Claude Desktop, Claude Code, etc.).

MCP es un estándar abierto que surgió en 2024-2025 y que para 2026 se está extendiendo ampliamente en el mundo de la IA, utilizado para conectar modelos de IA con datos y sistemas externos. Este proyecto es uno de esos servidores para Uzbekistán.

Qué puede hacer

• get_all_rates — devuelve el tipo de cambio oficial de todas las monedas de hoy

• get_exchange_rate — devuelve el tipo de cambio de hoy para una moneda (por ejemplo, USD)

• get_historical_rate — devuelve el tipo de cambio para una fecha pasada determinada

• convert_currency — convierte entre dos monedas según el tipo de cambio oficial (por ejemplo, calcula cuántos EUR son 100 USD)

Fuente de datos: la API JSON oficial y abierta de cbu.uz. No se requiere ninguna clave de API ni registro.

Related MCP server: Realtime Exchange Rate MCP Server

Instalación

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

Ejecución manual (para pruebas)

python -m uzcbu_mcp.server

El servidor se ejecuta mediante el transporte estándar stdio de MCP y espera solicitudes del cliente MCP.

Conexión a Claude Desktop

Abra el archivo de configuración de Claude Desktop (claude_desktop_config.json) y añada lo siguiente:

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

Reinicie Claude Desktop. Ahora, si le pregunta a Claude "¿cuál es el tipo de cambio del dólar hoy?" o "convierte 100 dólares a euros", llamará automáticamente a las herramientas de su servidor.

Pruebas

Para comprobar la lógica sin conexión a la red (con datos simulados):

python test_offline.py

Estructura del proyecto

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

Por qué destaca este proyecto

No es solo un "API wrapper": está construido sobre el Model Context Protocol, el nuevo estándar del ecosistema de IA, lo que significa que cualquier cliente de IA compatible con MCP (no solo un chatbot) puede utilizarlo. Actualmente hay muy pocos servidores MCP que trabajen con datos del contexto uzbeko (tipos de cambio oficiales del Banco Central).

Ideas de expansión

• Añadir otros datos estadísticos del CBU (inflación, tipos de interés)

• Acelerar mediante el almacenamiento en caché de resultados (unos minutos)

• Integrar con un bot de Telegram o un flujo de trabajo de N8N

• Añadir transporte HTTP/SSE para que el servidor funcione de forma remota

Licencia

MIT