mcpField
C
cbr-mcp

cbr-mcp

Local
github.com/theYahiaFinance1Updated 8w ago
Repository

About cbr-mcp

cbr-mcp exposes Central Bank of Russia data to AI clients, including exchange rates, key rates, and precious-metal prices. It supports historical queries and currency conversion without API keys, and falls back to another data source when the primary one is unavailable.

Key features

  1. 01Look up rates for a specific date
  2. 02View rate trends and statistics
  3. 03Get current and historical key rates
  4. 04Check precious-metal accounting prices
  5. 05Convert currencies at CBR rates
  6. 06Automatic fallback data source

Use cases

  1. 01Check a past USD or EUR rate
  2. 02Compare exchange-rate changes over time
  3. 03Look up current or historical key rates
  4. 04Estimate amounts in another currency

MCP support

It provides seven tools for MCP clients to query Russian central bank rates, key rates, precious-metal prices, and currency conversions. No authorization or API key is required.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "theyahia-cbr": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/cbr-mcp"
      ],
      "env": {
        "API_KEY": "<API_KEY>"
      }
    }
  }
}
Run commandnpx -y @theyahia/cbr-mcp
Environment variables to set
API_KEYSecretAPI key for the service

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@theyahia/cbr-mcp1.0.0

Tools

5

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
datestringNoDate in YYYY-MM-DD format (defaults to today)

Details

From the project README

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

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

npm License: MIT

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

Установка

Claude Desktop

Добавьте в claude_desktop_config.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)

ИнструментОписание
get_daily_ratesВсе курсы валют ЦБ РФ на указанную дату
get_currency_rateКурс конкретной валюты к рублю с изменением за день
get_rate_dynamicsДинамика курса валюты за период (ряд + min/max/avg, изменение)
get_key_rateТекущая ключевая ставка ЦБ РФ и дата её вступления в силу
get_key_rate_historyИстория изменений ключевой ставки за период
get_precious_metalsУчётные цены на золото, серебро, платину, палладий (покупка/продажа)
convert_currencyКонвертация суммы из одной валюты в другую через курс ЦБ
Особенности
  • Выходные и праздники. Если на запрошенную дату курсы не публиковались (выходной/праздник), возвращаются данные за ближайший доступный рабочий день с пометкой note.
  • Отказоустойчивость. Основной источник курсов — зеркало cbr-xml-daily.ru; при его недоступности используется официальный cbr.ru (XML_daily.asp) как fallback.
  • Источники данных: курсы — cbr-xml-daily.ru + cbr.ru/scripts/XML_daily.asp; динамика — cbr.ru/scripts/XML_dynamic.asp; ключевая ставка — cbr.ru/hd_base/KeyRate; металлы — cbr.ru/scripts/xml_metall.asp.

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

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

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

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

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

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

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

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

Часть серии WWmcp

MCPСтатусОписание
@metarebalance/dadata-mcp✅ готовАдреса, компании, банки, телефоны
@theyahia/cbr-mcp✅ готовКурсы валют, ключевая ставка
@theyahia/yookassa-mcp📅 скороПлатежи, возвраты, чеки 54-ФЗ
@theyahia/moysklad-mcp📅 скороСклад, заказы, контрагенты
...📅46 серверов — полный список

Разработка

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

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

Лицензия

MIT

Часть WWmcp · Telegram: @vhodvai

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.