Central Bank of Iran

---

面向 AI Agent

• **功能：**适用于 cbi.ir 的非官方 MCP 服务（模型上下文协议），提供官方汇率（约 48 种货币，历史数据可追溯至 1383 年）、按月和按年的通胀数据、每周银行间利率／常设便利利率、新闻和公告、流动性声明、报告（《经济趋势》、月度货币统计、年度回顾）。
• 安装：uvx cbi-mcp 或 claude mcp add cbi -- uvx cbi-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• **身份验证：**无需身份验证。可选设置 CBI_MCP_PROXY（HTTP 代理 URL）；系统代理设置会被忽略。
• **访问权限：**只读，调用任何工具前无需确认。
• **工具：**共 11 个，名称均以 cb_ 为前缀。典型调用顺序：cb_exchange_rates；cb_rate_history；cb_inflation；cb_news -> cb_news_item；cb_liquidity；cb_statistics；cb_bond_auctions；cb_policy_rates + cb_open_market。
• **适用场景：**用户询问某日官方美元／欧元／迪拉姆汇率、汇率走势、伊朗通胀、利率或银行间利率、流动性增长，或央行发布了哪些公告时。
• **不适用场景：**用户想查询自由市场（巴扎）汇率时，CBI 不会发布该数据；或想查询 CBI 时间序列数据库中的数据时（本项目构建时 tsd.cbi.ir 无响应）。
• **输出：**紧凑的 JSON。汇率单位为每单位货币对应的里亚尔数（per_units：JPY 为 100，KRW 为 1000 等）。答案中的日期采用波斯历；参数接受波斯历（1404/01/01）或公历（2025-03-21）。文本为波斯语。
• 机器可读信息：server.json。

为什么开发此工具

中央银行的网站是一个传统的 ASP.NET 网站：没有 API，每个日期各有一张汇率表，通胀数据藏在年份下拉菜单后， 流动性数据则埋在新闻和 Excel 文件中。cbi-mcp 会为 Agent 读取这些页面：

**你：**1404 年 1 Farvardin 的官方美元汇率是多少？现在的汇率又是多少？

**Agent：**调用 cb_exchange_rates(date="1404/01/01", currencies=["USD"]) 和 cb_exchange_rates(currencies=["USD"])

1404/01/01 为 579,503 里亚尔，1405/08/09 为 1,871,664 里亚尔。

_{真实数据读取自 cbi.ir，读取日期：2026-10-31。}

功能

• 官方汇率：查询某一天的汇率，包括今天或历史档案中的汇率；可查询所有货币或指定货币
• 汇率历史：查询一种货币的汇率；可在一次调用中查询最近 7 天的数据，也可查询数月或数年的抽样序列及总变化幅度
• 通胀：查询自 1361 年以来任意年份各月的 12 个月通胀率，以及自 1316 年以来的年度通胀率
• 政策利率：每周银行间利率、最低回购利率，以及常备借贷便利利率走廊
• 新闻：可按词语筛选的标题，以及任意新闻条目的全文
• 流动性：从最新的月度 Excel 文件中读取数值（流动性、货币、准货币、货币基础及其年度增长），以及行长的最新表态
• 月度统计表：从 Excel 文件中读取货币、国际收支（外债、官方市场、自由市场和优惠市场的月平均美元汇率）、财政和资本市场数据
• 政府伊斯兰债券拍卖：每周各债券的发行量、售出量和收益率
• 公开市场操作：每周回购拍卖数据
• 出版物：提供 PDF/Excel 链接，包括《经济趋势》、月度货币统计、年度经济回顾和银行间市场回顾

示例提示词：

• “CBI 今天的官方欧元汇率是多少？过去一周变化了多少？”
• “显示自 Farvardin 1404 以来每个月的美元汇率。”
• “伊朗目前的通胀率是多少？在 1403 年是如何变化的？”
• “中央银行最近对流动性增长说了什么？”
• 今天中央银行的官方美元汇率是多少？
• 请提供最新的经济指标报告。

快速开始

claude mcp add cbi -- uvx cbi-mcp

任何客户端：命令为 uvx，参数为 ["cbi-mcp"]。使用代理时，设置 CBI_MCP_PROXY=http://host:port。

工具

工具	返回内容
cb_exchange_rates	指定日期（默认为最新日期）约 48 种货币的官方汇率，可选货币筛选
cb_rate_history	一种货币的历史汇率及变化百分比；可查询最近 7 天，或两个日期之间的抽样数据
cb_inflation	某个 Jalali 年份的月度 12 个月通胀率及年度通胀历史
cb_policy_rates	某一年的每周银行间利率、回购利率和常备便利利率
cb_news	新闻标题（ID、日期），可选按词语和年份筛选
cb_news_item	某条新闻的全文和附件
cb_liquidity	从最新月度 Excel 文件中读取流动性、货币、准货币和货币基础（余额、年度增长），以及最新表态
cb_publications	最新的《经济趋势》、月度货币报告、年度回顾或银行间市场回顾及其文件链接
cb_statistics	月度 Excel 表格中任意工作表的行：monetary、balance_of_payments、fiscal、capital_market（年份、月份、工作表）
cb_bond_auctions	最新每周政府伊斯兰债券拍卖中各债券的结果：发行量、售出量、收益率
cb_open_market	每周公开市场操作报告及最新回购拍卖数据

常见问题

这是市场汇率吗？ 不是。这些是 CBI 的官方参考汇率；该网站不发布自由市场汇率。

为什么没有时间序列搜索？ 从尝试过的网络连接来看，中央银行的时间序列数据库（tsd.cbi.ir）没有响应。

它会读取 Excel/PDF 报告吗？ 月度 Excel 统计表（cb_statistics、cb_liquidity）、每周回购报告和拍卖结果会以数值形式读取。其他 Excel 和 PDF 报告则以链接形式返回。

许可证

MIT。非官方项目；与伊朗伊斯兰共和国中央银行无关联。数据归其发布者所有。

由 Sepehr Radmard（سپهر رادمرد）构建：github.com/sepehr071 · linkedin.com/in/sepehr-radmard

波斯语

cbi-mcp 是一个非官方、只读的 MCP 服务，用于访问伊朗伊斯兰共和国中央银行网站（cbi.ir）：官方汇率及其历史、通胀率、银行间市场利率、新闻和流动性表态，以及附下载链接的报告目录。无需密钥或账户。 安装：claude mcp add cbi -- uvx cbi-mcp