UZCBU MCP Server

UZCBU MCP Server

Сервер Model Context Protocol (MCP), который подключает официальные курсы валют Центрального банка Узбекистана (CBU.uz) к любому MCP-совместимому ИИ-ассистенту (Claude Desktop, Claude Code и другим).

MCP — это открытый стандарт, появившийся в 2024–2025 годах и к 2026 году широко распространяющийся в мире ИИ; он используется для подключения ИИ-моделей к внешним данным и системам. Этот проект — один из таких серверов для Узбекистана.

Что умеет

• get_all_rates — возвращает официальные курсы всех валют на сегодня

• get_exchange_rate — возвращает сегодняшний курс для одной валюты (например, USD)

• get_historical_rate — возвращает курс за определённую прошедшую дату

• convert_currency — конвертирует между двумя валютами по официальному курсу (например, вычисляет, сколько будет 100 USD в EUR)

Источник данных: официальный открытый JSON API cbu.uz. Не требуется никаких 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 долларов в евро», он автоматически вызовет инструменты (tools) вашего сервера.

Тестирование

Для проверки логики без выхода в сеть (с mock-данными):

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-обёртка» — он построен на основе Model Context Protocol, нового стандарта экосистемы ИИ, то есть им может воспользоваться любой MCP-совместимый ИИ-клиент (а не только один чат-бот). MCP-серверов, работающих с данными в контексте Узбекистана (официальные курсы Центрального банка), пока очень мало.

Идеи для расширения

• Добавить другие статистические данные CBU (инфляция, процентные ставки)

• Ускорить работу за счёт кэширования результатов (на несколько минут)

• Интегрировать с Telegram-ботом или N8N workflow

• Добавить HTTP/SSE-транспорт, чтобы сделать сервер работающим удалённо (remote)

Лицензия

MIT