Вкратце
MCP-сервер с прямым доступом к публичному XML/SOAP API Центробанка РФ. Позволяет AI-агенту в Cursor / Claude / Cline получать курсы валют (ЦБ + кросс-курсы), ключевую ставку, ставки рефинансирования и денежно-кредитные индикаторы.
Источник данных: Банк России (cbr.ru) . Atomno Labs не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-cbr-rates": {
"command": "uvx",
"args": ["atomno-mcp-cbr-rates"]
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-cbr-rates": {
"command": "uvx",
"args": ["atomno-mcp-cbr-rates"]
}
}
}В терминале (Claude Code CLI):
claude mcp add atomno-cbr-rates -- uvx atomno-mcp-cbr-rates
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-cbr-rates": {
"command": "uvx",
"args": ["atomno-mcp-cbr-rates"]
}
}
}Конфигурация (env vars)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_CBR_LOG_LEVEL | Уровень логирования (DEBUG/INFO/WARNING/ERROR) | — | no | INFO |
Тулзы MCP-сервера
Сервер регистрирует 5 тулов для AI-агента. Все валидируются через Pydantic v2.
get_currency_rate async tool Курс валюты ЦБ РФ на указанную дату (или сегодня).
currency_code: str, date?: str (YYYY-MM-DD) CurrencyRate { code, name, value, nominal, date } get_key_rate async tool Ключевая ставка ЦБ РФ на дату.
date?: str (YYYY-MM-DD) KeyRate { value, effective_from } get_currency_dynamics async tool Динамика курса валюты за период.
currency_code: str, date_from: str, date_to: str list[CurrencyRate] list_currencies async tool Список всех валют в справочнике ЦБ.
— list[Currency { code, name, num_code }] get_metals_prices async tool Учётные цены драгметаллов ЦБ РФ.
date?: str MetalsPrices { gold, silver, platinum, palladium } Примеры использования
Реальные prompt'ы для AI-агента в Cursor / Claude Code:
- get_currency_rate: «Используй mcp-cbr-rates тул
get_currency_rateи курс валюты цб рф на указанную дату (или сегодня).» - get_key_rate: «Используй mcp-cbr-rates тул
get_key_rateи ключевая ставка цб рф на дату.» - get_currency_dynamics: «Используй mcp-cbr-rates тул
get_currency_dynamicsи динамика курса валюты за период.»
Troubleshooting
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
Полный troubleshooting-гайд → /docs/troubleshooting
FAQ
Как установить mcp-cbr-rates? +
Какой Python нужен? +
Это open-source? +
Где сообщить о баге? +
Changelog
Текущая версия: v0.1.1. Полная история — GitHub Releases.
Source code & issues
- GitHub: atomno-labs/mcp-cbr-rates
- PyPI: atomno-mcp-cbr-rates
- Issues: atomno-labs/mcp-cbr-rates/issues
- Discussions: atomno-labs/mcp-cbr-rates/discussions
Disclaimer
Atomno Labs не аффилирован с Банк России (cbr.ru). mcp-cbr-rates использует публичные / коммерческие интерфейсы провайдера. Ответственность за соблюдение лимитов и ToS провайдера — на пользователе. Лицензия: MIT.