Statistical Centre of Iran

amar-mcp：伊朗统计中心（مرکز آمار ایران）通胀、失业率与人口普查 MCP 服务

amar-mcp 是一个非官方、只读的 MCP 服务，为 AI Agent 提供伊朗统计中心（amar.org.ir）的官方数据。
其 12 个工具可返回消费者价格指数和通胀数据（按月、同比、12 个月平均值，以及按 CPI 类别、家庭区域和省份划分）、失业率和劳动参与率、GDP 增长、生产者价格、月度宏观指标工作簿（贸易、住房价格和租金、货币、预算、家庭收入与支出、按收入十分位划分的 CPI）、按省和县划分的人口普查人口、新闻、发布日历，以及任何发布内容中的 Excel 表格。
无需 API 密钥或账户。可在 Claude、Cursor、Copilot 和其他任何 MCP 客户端中使用。

面向 AI Agent · 快速开始 · 工具 · 常见问题 · فارسی

---

面向 AI Agent

• 简介： 面向 amar.org.ir（伊朗国家统计门户网站）的非官方 MCP 服务（模型上下文协议），提供官方 CPI 和通胀数据、劳动力调查数据、1395 年人口普查人口数据、发布目录和日历，以及门户网站 Excel 表格的读取工具。
• 安装： uvx amar-mcp 或 claude mcp add amar -- uvx amar-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无。可选设置 AMAR_MCP_PROXY（HTTP 代理 URL 或逗号分隔的列表）；系统代理设置会被忽略。
• 访问权限： 只读。无法登录或更改任何内容，因此调用任何工具前都无需确认。
• 网络： amar.org.ir 仅对伊朗境内的连接响应（会丢弃来自国外 IP 的请求），因此请在伊朗网络连接下运行服务，或将 AMAR_MCP_PROXY 设置为伊朗代理。
• 工具： 共 12 个，名称均以 am_ 开头。常见调用顺序：am_inflation -> am_inflation_groups；am_gdp、am_ppi；am_indicators（主题 -> 表格）；am_search -> am_release -> am_table；查询“下一次何时发布”时使用 am_calendar。
• 适用场景： 用户询问伊朗官方通胀、CPI、失业率或人口数据，想了解通胀的影响因素（食品、住房……）、比较各省情况、查询伊朗统计中心的发布计划，或获取 amar.org.ir 上的任何表格时。
• 不适用场景： 用户需要中央银行数据、汇率或金价（其他服务提供这些数据），或实时市场数据时。月度 CPI Excel 序列比 PDF 报告晚约一周；am_inflation 会在 newer_report 中标明此情况，并从 PDF 中读取较新月份的全国数据。
• 输出： 精简的 JSON。时期采用伊朗历（1405-06 = 1405 年沙赫里瓦尔月）。百分比以百分数表示。名称和标题保留统计中心提供的波斯语原文。
• 机器可读信息： server.json。

示例

你： 伊朗的官方通胀率是多少？哪些因素推动了通胀？

Agent： 调用 am_inflation() 和 am_inflation_groups()

统计中心报告称，1405 年沙赫里瓦尔月的月度通胀率为 4.24%，同比通胀率为 89.8%，12 个月平均通胀率为 73.6%。食品和烟草价格同比上涨 122%，交通上涨 115%，住房上涨 38%。

_{数据来自 2026-11-01 的实时调用。}

其他提示词：“按季度查询失业率”、“亚兹德省及其各县的人口”、“法尔斯省的通胀率”、“下一次 CPI 发布是什么时候”，تورم نقطه به نقطه مسکن شهری چقدر است؟，نرخ بیکاری آخرین فصل؟

快速开始

你需要 uv。无需 API 密钥或账户。

Claude Code： claude mcp add amar -- uvx amar-mcp

Claude Desktop、Cursor、Windsurf、Gemini CLI： 添加

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

VS Code： 在 .vscode/mcp.json 中添加 {"servers": {"amar": {"type": "stdio", "command": "uvx", "args": ["amar-mcp"]}}}。

Codex CLI： codex mcp add amar -- uvx amar-mcp。其他情况：运行 uvx amar-mcp，或运行 pip install amar-mcp 后执行 amar-mcp。

工具

工具	功能
am_inflation	按家庭所在地区、CPI 分组或省份查询官方 CPI 指数和每月通胀率（按月、同比、12 个月平均）
am_inflation_groups	比较一个月内不同 CPI 分组（食品、住房、交通等）的通胀率
am_labour_force	按季度查询失业率、青年失业率和参与率，以及总计、城镇和农村数据
am_population	根据 1395 年人口普查查询各省人口和家庭数，或查询一个省内各县的人口和家庭数
am_search	按波斯语标题词、年份、频率、类型和主题搜索门户网站发布的内容
am_release	查询一项发布内容：主题、时期及其 Excel、PDF 和 Word 文件
am_table	将发布内容中的任意 Excel 表格读取为紧凑的行（工作表列表、筛选、分页）
am_calendar	发布日历：每月哪一天发布哪项统计数据
am_gdp	按季度或年份查询 GDP 增长率，以及农业、工业、石油和天然气、服务业数据；水平值以十亿里亚尔计
am_ppi	按季度和行业查询生产者价格指数（指数、季度、同比、4 个季度平均）
am_indicators	月度宏观工作簿：贸易、住房价格和租金、货币、预算、家庭支出、基尼系数、按收入十分位和省份划分的 CPI、能源、股票市场
am_news	查询该中心的最新新闻和新闻稿，或单条内容的正文

全部 12 个工具均标注为 readOnlyHint: true。

工作原理

  AI agent  ──MCP/stdio──▶  amar-mcp  ──HTTPS──▶  amar.org.ir  (release pages, Excel files)

该门户没有 JSON API，因此服务会读取其目录页面，并下载门户自身提供的 Excel 文件，然后进行解析。它会发送类似浏览器的请求（Chrome TLS 指纹），最多同时发送 3 个请求，将结果缓存 5 分钟，并拒绝超过 25 MB 的文件。该网站的证书链不完整（缺少一个中间证书）；服务会附带该公开的中间证书，以便正常验证连接。

常见问题

为什么从伊朗境外无法使用？ amar.org.ir 不响应来自国外 IP 的请求。请在伊朗网络环境下运行，或设置 AMAR_MCP_PROXY。

为什么 am_inflation 缺少最新月份的数据？ 该中心会先发布 PDF 报告，约一周后再更新 Excel 序列。答案中的 newer_report 会指出该报告（使用 am_release 获取 PDF 链接）；其中还包含从 PDF 中读取的该月全国指数和通胀率。

这些数据与中央银行的数据相同吗？ 不同。这些是伊朗统计中心的数据；伊朗中央银行会发布自己的数据。

它与该中心有关联吗？ 没有关联。它读取公开页面和文件，无需登录。

波斯语

amar-mcp 是面向国家统计门户（伊朗统计中心，amar.org.ir）的非官方只读 MCP 服务。你可以用它查询通胀和消费者价格指数（按月、同比、12 个月平均；按商品组、城镇和农村地区以及省份划分）、失业率和参与率、1395 年人口普查中的各省和县人口、发布日历，以及任何已发布的 Excel 表格。

安装：claude mcp add amar -- uvx amar-mcp（需要 uv）。统计中心门户仅响应来自伊朗境内的请求；请在伊朗网络环境下运行该服务，或将 AMAR_MCP_PROXY 设置为伊朗代理。

_{作者：Sepehr Radmard（سپهر رادمرد），github.com/sepehr071，linkedin.com/in/sepehr-radmard。MIT 许可证。}