cbar

Name: cbar
Author: azerbaijan-mcp

本地服务

github.com/azerbaijan-mcp金融数据13 天前更新

代码仓库

关于 cbar

cbar 是面向需要阿塞拜疆央行官方参考汇率的客户端的 MCP 服务，可查询汇率并通过 AZN 换算。它读取 CBAR 公开的 XML 数据源。

主要功能

01查询 38 种货币汇率
02查询 4 种贵金属汇率
03按货币代码筛选汇率
04通过 AZN 换算货币
05查看所用汇率表日期

适用场景

01查询 USD 或 EUR 官方参考汇率
02换算支持的货币金额
03获取指定日期的历史汇率

MCP 相关

它向 MCP 客户端提供 `get_rates` 和 `convert` 工具，并读取 CBAR 公开的 XML 数据源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "azerbaijan-mcp-cbar": {
      "command": "uvx",
      "args": [
        "azerbaijan-mcp-cbar"
      ]
    }
  }
}

启动命令uvx azerbaijan-mcp-cbar

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiazerbaijan-mcp-cbar0.1.0stdio

工具

收录的工具列表 · 更新于 5 天前

参数	类型	必填	说明
date	any	否	YYYY-MM-DD。默认为今天（巴库时间）。
codes	any	否	仅限这些代码，例如 ["USD", "EUR"]。默认：全部。

详细介绍

azerbaijan-mcp-cbar

用于获取阿塞拜疆共和国中央银行（CBAR）官方汇率的 MCP 服务。它读取 CBAR 的公开 XML 数据源（https://cbar.az/currencies/DD.MM.YYYY.xml）：无需 API 密钥，也不进行网页抓取。

工具

工具	功能
`get_rates(date?, codes?)`	获取 38 种货币和 4 种贵金属的 AZN 官方汇率。`date` 格式为 `YYYY-MM-DD`（默认值：巴库时间的当天）。`codes` 用于筛选，例如 `["USD", "EUR"]`。
`convert(amount, from_currency, to_currency, date?)`	使用官方汇率通过 AZN 进行换算。`AZN` 可用作代码。

需要了解的信息：

汇率以每 nominal 单位对应的 AZN 表示。七种货币按 100 单位报价（JPY、KRW、KZT、HUF、UZS、PKR、RUB）。per_unit 已完成除算。
贵金属汇率以每金衡盎司对应的 AZN 表示。
CBAR 在周末和公共假日不发布新表。响应会说明使用的是哪张表（sheet_date、note）。
这些是官方参考汇率，并非银行的买入／卖出汇率。

安装

添加到 MCP 客户端配置中（需要 uv）：

{
  "mcpServers": {
    "cbar": {
      "command": "uvx",
      "args": ["azerbaijan-mcp-cbar"]
    }
  }
}

在 Claude Code 中：claude mcp add cbar -- uvx azerbaijan-mcp-cbar。

数据来源与条款

数据由 CBAR 发布于 https://cbar.az/currency/rates，该页面允许将 XML URL 导入应用程序。页面未说明许可或复用条件，因此本服务依据这一默示许可，缓存响应（过去日期的响应永久缓存，当天的响应缓存 10 分钟），并发送真实的 User-Agent。每个响应都包含归属信息字段。本项目为非官方项目，与 CBAR 无关联，也未获其认可。

tests/fixtures/rates-2026-10-30.xml 是公开数据源在 2026-10-30 的快照。

支持 Markdown

登录后评论