MCP-сервер для API ЦБ РФ — курсы валют, ключевая ставка и драгметаллы через ИИ
Если вы искали, как получить официальный курс доллара или евро на нужную дату, узнать ключевую ставку ЦБ или пересчитать сумму по курсу Банка России прямо в чате — это оно. 7 инструментов, без авторизации и ключей: поставили через npx и сразу спрашиваете. «Какой был курс евро 15 марта» — цифра из официального источника, а не из поисковой выдачи.
Часть серии 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.
Примеры запросов
Какой курс доллара сегодня?
Как менялся курс доллара с 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
npm run lint
npm test
npm run dev
Тесты не ходят в сеть — парсеры проверяются на сохранённых ответах API в test/fixtures/.
История изменений — в CHANGELOG.md.
Лицензия
MIT
Часть WWmcp · Telegram: @vhodvai