Big Mac Index

@pipeworx/big-mac-index

《经济学人》的巨无霸指数：约 55 个国家的巨无霸价格（以当地货币和美元计价），以及各货币相对于美元、欧元、英镑、日元和人民币的高估或低估程度（原始值和按人均 GDP 调整后的值）。涵盖 2000 年至最新发布的数据，指数每年发布两次。

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

工具

• big_mac_index(country?, date?, history?, limit?)：获取某个国家在某期指数中的数据（默认为最新一期）。数据包含当地价格、美元汇率、美元价格，以及相对于 USD、EUR、GBP、JPY 和 CNY 的原始估值和按 GDP 调整后的估值。设置 history: true 可获取 2000 年以来的所有发布数据。省略 country 可列出某期指数中的所有国家。可回答“瑞士法郎是否被巨无霸指数高估？”
• big_mac_valuation(base_currency?, date?, adjusted?, limit?)：按相对于某种基准货币的估值对某期指数中的所有货币进行排名，最高估值排在最前。可回答“巨无霸指数中哪些货币最便宜？”

估值以百分比表示。+45.4 表示当地货币相对于基准货币高估 45.4%，-30 表示低估 30%。日期参数（YYYY、YYYY-MM 或 YYYY-MM-DD）会解析为不晚于该日期的最新一期指数。每个响应都包含 data_as_of（指数中的最新发布日期）、source 和 licence。如果国家不在指数中，响应会返回 found: false，并附上指数中包含的国家列表。

身份验证

无需密钥。

数据来源

• 《经济学人》，巨无霸指数（big-mac-data 仓库，完整指数）：《经济学人》计算的价格、汇率、原始估值和按 GDP 调整后的估值。

许可协议。 big-mac-data 仓库采用 MIT License 发布，版权归 2018 The Economist Newspaper 所有：“特此免费授予任何获得本软件及相关文档文件副本的人……不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和／或出售软件的权利。”每个响应都包含出处信息。每次调用都会在请求时读取已发布的指数。

给下一位维护者的说明：

• 国家名称遵循《经济学人》的用法：“Britain”，而非“United Kingdom”；欧元则使用“Euro area”（ISO 代码 EUZ）。常见别名（UK、US、eurozone、UAE）会进行映射。
• 仅对《经济学人》有 GDP 数据的国家发布按 GDP 调整后的数据；其他国家的值为 null。
• 2012 年之前的发布不定期（一年一至两次，时间在 1 月、4 月、5 月、6 月或 7 月）。从 2012 年起，每年于 1 月和 7 月发布。2019 年 7 月的一期日期为 9 日，2020 年 1 月的一期日期为 14 日。
• 来源中的委内瑞拉货币代码曾从 VEF 更改为 VES，因此请按名称或 VEN 匹配。

快速开始

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

{
  "mcpServers": {
    "big-mac-index": {
      "url": "https://gateway.pipeworx.io/big-mac-index/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/big-mac-index/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 都连接到同一个网关和相同的 1875+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

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

首次调用无需账号。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/big_mac_index。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

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

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

也可以直接运行，确认服务能够启动：

npx -y @pipeworx/mcp-big-mac-index

它通过 stdin/stdout 进行 MCP 通信，并响应 initialize/tools/list/tools/call，且仅提供此工具包的工具——不包含上述网关连接额外提供的任何共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——此方式既适用于上述工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Big Mac Index data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT