China Safe

@pipeworx/china-safe

中国的官方储备资产、国际收支和外债—— 外汇储备、国际收支、外债—— 数据解析自 SAFE（国家外汇管理局）的英文数据页面。

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

工具

• china_fx_reserves({months}) — 月度官方储备资产：主要外汇储备、在 IMF 的储备头寸、SDR 持有量、黄金（价值和盎司数）、其他储备资产及总额。按月发布，通常在月末后一周左右。经 2026-09-07 核实：最新月份为 2026 年 8 月——外汇储备为 3,438.325bn 美元，官方储备资产总额为 3,854.885bn 美元——于 2026-09-07 发布。
• china_balance_of_payments({quarters, currency}) — 季度国际收支摘要：经常账户（货物、服务、初次收入和二次收入）、资本和金融账户（含储备资产变动），以及净误差与遗漏。currency 可为 usd（默认值）、rmb 或 sdr。按季度发布，通常在季末约 3 个月后——这是标准的 BPM6 发布周期，并非网站数据陈旧。经 2026-09-07 核实：最新季度为 2026Q1，于 2026-06-26 发布。
• china_external_debt({quarters}) — 自 2014Q4 起的季度外债总头寸：总额、按原始合同期限分类（短期／长期），以及按机构部门分类（一般政府、中央银行、其他存款性公司、其他部门、直接投资关联企业间贷款）。发布滞后与国际收支数据相同，均约为 3 个月。经 2026-09-07 核实：最新季度为 2026Q1，于 2026-06-26 发布。
• china_safe_releases({limit}) — 其他三个工具背后的真实发布日期，读取自每个来源页面自身的 PubDate 元数据及其附件的上传时间戳，而非页面的永久链接。如果调用方关注数据时效性，请在引用其他工具的数据前使用此工具。

认证

无需密钥。

数据源

• https://www.safe.gov.cn/en/ForexReserves/index.html — 官方储备资产，每个日历年一个累计 .xlsx 文件（列为 YYYY.01–YYYY.12）。
• https://www.safe.gov.cn/en/BalanceofPayments/index.html — 一个 .xlsx 文件，包含完整的国际收支时间序列，分年度和季度工作表，每种均提供人民币／美元／SDR数据。
• https://www.safe.gov.cn/en/ExternalDebt/index.html — 一个 .xlsx 文件，包含按部门分类的外债总头寸，数据按季度提供，自 2014Q4 起。

此处记录了一些陷阱，避免后来者重复踩坑

• 永久链接 URL 不是发布日期。 SAFE 会在原 URL 上重新发布每年的储备表以及国际收支平衡表／债务时间序列，而该 URL 可能早在数年前就已创建——例如，“Official Reserve Assets (2026)”位于 /en/2021/0203/2045.html，这是一个带有 2021 年日期的路径；截至 2026-09-07，该页面仍在实时更新数据。请相信文章页面自身的 <meta name="PubDate">，以及附件文件自身路径中嵌入的日期（/en/file/file/20260907/....xlsx），绝不要相信永久链接。
• 没有 JSON、没有 CSV，也没有包含这些数字的 HTML 表格。 每个文章页面都只链接到一个 .xlsx 文件（通常还有对应的 .pdf 文件）；页面正文只是一个占位页面。本项目包使用手写的、无依赖的 ZIP+XML 读取器（src/xlsx.ts，移植自 ema-medicines 包的读取器）直接解析 .xlsx——一个 Worker 无法承载完整的 xlsx 库来处理三个文件。
• xlsx 链接的锚文本因页面而异。 储备页面使用普通锚文本（<a href="...">xlsx</a>）；国际收支平衡表／外债页面则将完整报告标题作为锚文本，文件名只出现在 title="..." 属性中。请根据 .xlsx href 扩展名进行匹配，而不是锚文本。
• 储备行按位置固定，而不是通过重复的列标题确定。 每个月份对应一对列（先 USD，后 SDR），但只有 USD 列带有“YYYY.MM”标题文本——SDR 列是合并单元格，没有自己的标题。六个指标行（外汇储备、IMF 头寸、SDR、黄金价值、黄金盎司数、其他储备资产、总计）在工作表中的行号固定；发货前已对照实时文件核实（行总计与列合计精确到分）。
• 国际收支平衡表包含约 280 行的 BPM6 明细；本项目包提供其中 17 条汇总行，而非完整的子账户细节（按金融工具和部门划分的明细有四层）。行号通过匹配 A 列中规范化后的标签文本动态查找，而不是硬编码，因为 RMB／USD／SDR 工作表复用相同模板。
• 外债部门总计等于各自短期和长期小计行之和，而总计等于五个部门总计之和——发货前已对照 2026Q1 实时数据核验（24,120.799 = 3,601.510 + 1,034.221 + 9,886.860 + 6,820.844 + 2,777.364）。
• 黄金盎司数以 10,000 为单位报告（万盎司）——例如，“7673万盎司”即 76,730,000 盎司；本项目包会直接转换为 gold_million_oz。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/china-safe/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember／recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个项目包端点会列出大约 30 个共享工具，以及该项目包自身的工具。连接的 initialize 响应会说明其确切范围，并且是当天适用的权威信息。

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

或者，连接完整的 Pipeworx 网关，直接列出所有项目包的工具，而不只是此项目包的工具：

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

两个 URL 都会连接到同一个网关和相同的 1875+ 个数据源。唯一的区别是哪些项目包的工具会被直接列出；从任一端点都可以通过 ask_pipeworx 访问所有工具。

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-china-safe

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此软件包的工具，不包含上述网关连接额外提供的共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具；这既适用于上面的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about China Safe data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT