IMF经济数据协议服务器

一个基于IMF经济数据的模型上下文协议服务器,提供IMF数据库查询、参数定义获取和数据提取功能。

  • by c-cf
  • Python
  • 本地部署
  • 14 星标
  • 更新于
在 GitHub 查看 c-cf/imf-data-mcp

使用说明

国际货币基金组织数据MCP

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

v0.2.0--突破性变化: 旧服务器调用 dataservices.imf.org, 国际货币基金组织于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桌面配置

{
  "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允许大约10个请求/5秒。 imfp 手柄 速率限制和自动重试。


调试

npx @modelcontextprotocol/inspector imf-data-mcp

许可证

Apache 2.0