Imf

IMF — 国际货币基金组织数据

国际货币基金组织的宏观数据库。涵盖 190 多个成员国的国家级 GDP、通胀、经常账户、财政收支、汇率、债务、就业和人口统计数据。跨国宏观数据的标准来源。免费，无需认证。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1881 多个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

这对 AI Agent 的重要性

对于跨国宏观分析，IMF 的数据库（WEO —《世界经济展望》；IFS —《国际金融统计》；BOP —《国际收支》）是权威来源。FRED 以美国为重点，而 IMF 覆盖全球并经过协调。世界银行侧重发展，而 IMF 侧重宏观、财政和金融。

常见工作流：

• 国家宏观概览。 获取某个国家的 GDP、通胀和经常账户数据。
• 跨国比较。 提取多个国家的同一指标进行比较。
• 时间序列分析。 使用历史数据进行趋势分析。

供 trade_country_profile 复合工具使用，也适合搭配 Comtrade（贸易流量）和 BLS（美国劳动力数据）。

认证

无需认证。IMF Data API 完全公开且免费。

主要数据库

数据库	覆盖范围	用途
WEO（《世界经济展望》）	年度和半年度	GDP、通胀、财政、经常账户预测
IFS（《国际金融统计》）	月度／季度	货币、银行、价格、政府财政
BOP（《国际收支》）	季度	经常账户、资本账户和金融账户
DOTS（贸易方向）	月度	双边贸易（与 Comtrade 数据互为镜像）
GFS（《政府财政统计》）	年度	政府收入、支出、债务

常见注意事项

• 国家代码格式不同。 IMF 使用 ISO 三字母代码（USA、GBR、DEU）。Comtrade 使用三位数字代码。Census 使用两字母代码。跨来源关联时需要进行转换。
• WEO 每年发布两次。 分别在 4 月和 10 月发布。不同版本之间的预测可能大幅变化——务必注明版本（例如“WEO 2024 年 10 月版”）。
• 汇率定义各不相同。 包括期间平均汇率、期末汇率、购买力平价汇率和实际有效汇率。IMF 数据涵盖这四种；请注明使用哪一种。
• 数据覆盖缺口。 小型经济体和政治上较孤立的国家（朝鲜、委内瑞拉、厄立特里亚）数据较零散。IMF API 会返回 null；不要将 null 视为零。
• 实际值与名义值。 默认 GDP 为按现价美元计的名义值。要进行跨时间比较或比较通胀快速的经济体时，通常应使用实际值（经通胀调整、按不变价格计）或按购买力平价调整后的数据。
• 发布延迟。 年度数据的发布时间视各国报告情况而定，通常滞后 6–18 个月。季度数据发布更快，主要经济体约滞后 2–3 个月。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "imf": {
      "url": "https://gateway.pipeworx.io/imf/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/imf/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于表格所列：目前，单个工具包端点除了列出该工具包自带的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切范围，并且是当天情况的权威答案。

这是有意为之，并非意外的多路复用。元工具让限定范围的连接也能回答该工具包未涵盖的问题——通过可路由整个目录的 ask_pipeworx 实现——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义消耗的上下文超过了路由功能带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和同一组 1881+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/get_datasets \
  -H 'Content-Type: application/json' \
  -d '{}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/get_datasets。查找工具包：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "imf": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-imf"]
    }
  }
}

或者直接运行，确认它能够启动：

npx -y @pipeworx/mcp-imf

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上文网关连接额外提供的共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——上面的工具包端点和完整网关都支持此功能：

ask_pipeworx({ question: "your question about Imf data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT