IMF Data MCP

IMF Data MCP

一个用于 IMF 经济数据的模型上下文协议服务器，基于 imfp 和 位于 data.imf.org 的 IMF SDMX API。

v0.2.0 — 重大变更： 旧服务器调用的 dataservices.imf.org 已由 IMF 于 2025 年停用。 因此，所有请求都会超时。 此版本迁移至 imfp，该库面向当前的 data.imf.org SDMX 3.0 API，并持续维护。

---

安装

使用 uv（推荐）

uvx --from git+https://github.com/c-cf/imf-data-mcp imf-data-mcp

使用 pip

pip install git+https://github.com/c-cf/imf-data-mcp.git

---

Claude Desktop 配置

{
  "mcpServers": {
    "imf": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/c-cf/imf-data-mcp", "imf-data-mcp"]
    }
  }
}

或者，如果通过 pip 安装：

{
  "mcpServers": {
    "imf": {
      "command": "imf-data-mcp"
    }
  }
}

---

可用工具

工具	描述
imf_list_databases	列出所有约 155 个 IMF 数据库及其 ID
imf_search_databases	按关键词筛选数据库（例如 "inflation"、"trade"）
imf_get_parameter_defs	列出数据库的查询维度
imf_get_parameter_codes	列出某个维度的有效代码，可选搜索
imf_fetch_data	获取时间序列数据，可按年份范围和维度筛选

---

典型工作流

1. imf_search_databases(keyword="consumer price")
   → CPI, CPI_WCA, ...

2. imf_get_parameter_defs(database_id="CPI")
   → country, index_type, coicop_1999, frequency, ...

3. imf_get_parameter_codes(database_id="CPI", parameter="country", search="austria")
   → AUT

4. imf_fetch_data(
       database_id="CPI",
       start_year=2015, end_year=2023,
       filters={"country": ["AUT"], "frequency": ["M"]}
   )

---

常见数据库 ID

主题	ID
消费者价格	CPI
生产者价格	PPI
国民账户（年度）	ANEA
国民账户（季度）	QNEA
国际收支	BOP_AGG
汇率	ER_2026_JAN_VINTAGE
大宗商品价格	PCPS
财政监测	FM
政府财政统计	GFS_COFOG
货币统计	MFS_CBS、MFS_MA、MFS_IR
金融稳健性	FSIC
服务贸易	ITS
SDG 数据	SDG

---

速率限制

IMF API 大约允许每 5 秒发送 10 个请求。imfp 会自动处理速率限制和重试。

---

调试

npx @modelcontextprotocol/inspector imf-data-mcp

---

许可证

Apache 2.0