English Français العربية

io.github.theYahia/cbr-mcp

السجل الرسمي المالية والمدفوعات

MCP server for Central Bank of Russia API — currency rates, key rate, precious metals, conversion.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @theyahia/cbr-mcp
Claude Code 
claude mcp add cbr-mcp -e 'API_KEY=<your api_key>' -- npx -y @theyahia/cbr-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "cbr-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/cbr-mcp@1.0.0"
            ],
            "env": {
                "API_KEY": "<your api_key>"
            }
        }
    }
}

متغيرات البيئة

  • API_KEY سري API key for the service

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MCP-сервер для API ЦБ РФ — курсы валют, ключевая ставка и драгметаллы через ИИ
  2. Установка
  3. Инструменты (7)
  4. Примеры запросов
  5. Часть серии WWmcp
  6. Разработка
  7. Лицензия

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.

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

Какой курс доллара сегодня?
Переведи 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

الأسئلة الشائعة

ما هو io.github.theYahia/cbr-mcp؟

MCP server for Central Bank of Russia API — currency rates, key rate, precious metals, conversion.

كيف أثبّت io.github.theYahia/cbr-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add cbr-mcp -e 'API_KEY=<your api_key>' -- npx -y @theyahia/cbr-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.theYahia/cbr-mcp إلى مفتاح API؟

نعم. يتطلب API_KEY، وتضبطها في إعداداته.

هل io.github.theYahia/cbr-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.theYahia/cbr-mcp؟

ينشره theYahia. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.