mcp-cbr-rates 是一个 Model Context Protocol（MCP）服务器，公开俄罗斯中央银行（Центральный банк РФ，CBR）的公共数据，包括货币报价、关键利率、通胀以及一份紧凑的宏观快照，供 AI 智能体使用。该项目是 atomno 系列 MCP 服务器的一部分，聚焦俄罗斯金融科技生态。它完全开源，无需 API 密钥，构建于 CBR 官方公开端点之上。
用途 该项目面向需要俄罗斯央行公开金融数据的 AI 智能体场景，例如查询某日官方汇率、获取某段时期的历史汇率走势、读取最新关键利率与通胀数据，或一次性获取综合宏观统计快照。数据端点均为只读且免费。
主要能力 提供五个高质量的 MCP 工具，每个工具都带有严格的 Pydantic 模式：get_rate、history_rates、key_rate、inflation、statistics。内置 TTL（Time-To-Live）缓存：每日报价缓存 1 小时，历史序列缓存 24 小时，以礼貌对待数据源。使用 async httpx 传输，并在 5xx 错误时自动重试。通过 defusedxml 进行安全的 XML 解析。项目包含 50 多个单元测试，使用 respx 模拟 HTTP，覆盖率不低于 80%。不含密钥、遥测或第三方追踪器。
使用方式 可从 PyPI 安装（推荐），也可从源码安装。支持与 Cursor、Claude Desktop、Claude Code 等客户端配合使用。Cursor 需在 .cursor/mcp.json（或全局 ~/.cursor/mcp.json）中添加配置；Claude Desktop 需添加到 claude_desktop_config.json，Windows 配置位于 %APPDATA%\Claude\claude_desktop_config.json，macOS 位于 ~/Library/Application Support/Claude/claude_desktop_config.json。以下为资料中给出的示例用法（纯英文描述）：
- “What was the official EUR rate on April 25, 2024?” 工具：get_rate(char_code="EUR", on_date="2024-04-25")。
- “Plot the daily USD-RUB rate over the last 90 days.” 工具：history_rates(char_code="USD", date_from=..., date_to=...)。
- “Give me the latest key rate, USD/EUR/CNY, and inflation in one go.” 工具：statistics()。 history_rates 窗口上限为 366 天，更长周期需重复调用该工具。所有设置均为可选，并从环境变量读取；为兼容性仍接受旧版 CBR_* 名称，但新配置应使用 MCP_CBR_*。无需配置 API 密钥，所用 CBR 端点均为公开。
数据来源 https://www.cbr.ru/scripts/XML_daily.asp — 每日货币报价。 https://www.cbr.ru/scripts/XML_dynamic.asp — 历史货币序列。 https://www.cbr.ru/scripts/XML_valFull.asp — 货币代码查询。 https://www.cbr.ru/DailyInfoWebServ/DailyInfo.asmx — 用于 CBR 关键利率的 SOAP 服务。 https://www.cbr.ru/hd_base/infl/ — 月度同比通胀表。 所有端点均为只读且免费。
适用场景 适合需要以标准化工具方式接入俄罗斯央行公开数据的 AI 智能体开发与集成场景，包括汇率查询、历史走势分析、关键利率与通胀读取，以及宏观统计快照获取。
限制 该项目与俄罗斯中央银行无任何关联，是非官方、尽力而为的公开数据封装。使用风险自负；作者对通过该服务器交付数据的新鲜度、准确性或适用性不承担任何责任。如果 CBR 的 HTML 或 XML 模式发生变化，部分工具可能停止工作，直到本包更新；若发现回归问题，应提交 issue。许可证为 MIT，详见 LICENSE。
