Cbr MCP server

MCP-сервер для API ЦБ РФ — курсы валют, ключевая ставка и драгметаллы через ИИ

Если вы искали, как получить официальный курс доллара или евро на нужную дату, узнать ключевую ставку ЦБ или пересчитать сумму по курсу Банка России прямо в чате — это оно. 7 инструментов, без авторизации и ключей: поставили через npx и сразу спрашиваете. «Какой был курс евро 15 марта» — цифра из официального источника, а не из поисковой выдачи.

Часть серии WWmcp (46 серверов) by @theYahia.

Установка

Claude Desktop

Добавьте в claudedesktopconfig.json:

{
  "mcpServers": {
    "cbr": {
      "command": "npx",
      "args": ["-y", "@theyahia/cbr-mcp"]
    }
  }
}

Claude Code

claude mcp add cbr -- npx -y @theyahia/cbr-mcp

VS Code / Cursor

Добавьте в .vscode/mcp.json:

{
  "servers": {
    "cbr": {
      "command": "npx",
      "args": ["-y", "@theyahia/cbr-mcp"]
    }
  }
}

Windsurf

Добавьте в настройки MCP Toolkit:

{
  "mcpServers": {
    "cbr": {
      "command": "npx",
      "args": ["-y", "@theyahia/cbr-mcp"]
    }
  }
}

Авторизация не нужна — API ЦБ РФ полностью открытый.

Инструменты (7)

Особенности

возвращаются данные за ближайший доступный рабочий день с пометкой note.

• Выходные и праздники. Если на запрошенную дату курсы не публиковались (выходной/праздник),

недоступности используется официальный cbr.ru (XML_daily.asp) как fallback.

• Отказоустойчивость. Основной источник курсов — зеркало cbr-xml-daily.ru; при его

динамика — cbr.ru/scripts/XMLdynamic.asp; ключевая ставка — cbr.ru/hdbase/KeyRate; металлы — cbr.ru/scripts/xml_metall.asp.

• Источники данных: курсы — cbr-xml-daily.ru + cbr.ru/scripts/XML_daily.asp;

Примеры запросов

Какой курс доллара сегодня?

Переведи 1000 USD в евро

Как менялся курс доллара с 1 по 23 июня?

Какая ключевая ставка ЦБ и с какого числа она действует?

Покажи историю ключевой ставки за последний год

Какие цены на золото и серебро?

Покажи курсы валют на 10 января 2025

Часть серии WWmcp

Разработка

npm install
npm run build      # компиляция TypeScript → dist/
npm run lint       # eslint
npm test           # vitest (юнит-тесты парсеров на офлайн-фикстурах)
npm run dev        # запуск из исходников через tsx

Тесты не ходят в сеть — парсеры проверяются на сохранённых ответах API в test/fixtures/. История изменений — в CHANGELOG.md.

Лицензия

MIT

Shortened. The full README is on GitHub.