China Macro

@pipeworx/china-macro

中国人民银行贷款市场报价利率（贷款市场报价利率，LPR）、国家统计局主要指标、70 城房价、SHIBOR 和国债收益率曲线——无需密钥，实时获取数据。

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

工具

• china_lpr({ months? }) — 最多返回最近 12 次月度 LPR 公告 （1 年期和 5 年期利率，以及参考日期），按时间从新到旧排列，并包含 latest 字段。上游仅提供滚动的约 1 年数据窗口——months 上限为 12。
• china_lpr_latest() — 仅返回当前 1 年期／5 年期 LPR 报价及其参考日期，不含历史数据。调用方只需查询“当前利率”时成本更低。
• china_macro_indicator({ indicator, periods? }) — 一个工具涵盖九项主要指标：cpi、ppi、pmi（制造业 + 非制造业）、gdp（按行业划分的年内累计值）、industrial_production（规模以上工业增加值增长）、retail_sales、fixed_asset_investment、money_supply（M0/M1/M2）和 trade（月度进出口总额）。 返回最近一期数据，并附带最多 periods 期（默认 12，最多 36）的月度／季度历史数据。每个字段均按单位从国家统计局的中文名称翻译为英文名称。 直连数据源（source: "nbs"）。 读取中国国家统计局自有数据库，而非转载方数据。每个序列均包含 period、period_type（single_month / single_quarter / year_to_date）、measure（index、pct_change_yoy、pct_change_qoq、change_pp、level、level_pct、rate_pct、diffusion_index）、unit 和 base（例如“上年同月 = 100”），均按原始发布形式返回，不进行转换；由于转载方使用的单位名称可能有误（例如将基期为 100 的指数标为“%”），因此其单位名称保存在 published_unit 中。如果无法根据转载方的标签确定某个序列的基期，则返回 basis_status: "unresolved"，并且仅将数值作为 value_raw 返回。空白期数会被剔除并计数，不会以 null 值返回。此外，还提供 urban_unemployment 和 capacity_utilization（季度数据）、series（一个命名序列）、period 和 region：历史数据使用省份名称，单期的 31 个中国大陆省级地区数据则使用 "all"（适用于 cpi、ppi、industrial_production、fixed_asset_investment、gdp）。这些序列不包含台湾、香港和澳门。
• china_house_prices({ city?, month? }) — 70 个城市的新建商品住宅和二手住宅价格指数。使用 city（英文名称）获取一个城市的历史数据（最多 24 个月）；使用 month（“YYYY-MM”）指定某次发布；两者都不指定则返回最新月份全部 70 个城市的横截面数据。
• china_rates({ series, days?, periods? }) — series: "shibor" 返回涵盖全部 8 个期限的上海银行间同业拆放利率（最新定盘利率 + 每日历史数据）；series: "yield_curve" 返回中国国债收益率曲线（含带日期的 1 年期／10 年期基准历史数据，以及所有活跃交易期限的实时报价完整曲线）。

身份验证

无需密钥。无需 Cookie 或会话。

数据来源

• 中国人民银行授权的全国银行间同业拆借中心 — 贷款市场报价利率（china_lpr、china_lpr_latest）。
• 中国国家统计局 — CPI、PPI、PMI、GDP、工业增加值增速、社会消费品零售总额、固定资产投资、货币供应量以及 70 个大中城市住宅价格指数（china_macro_indicator、china_house_prices）。
• 中国国家统计局国家及省级统计数据库——直接查询路径（source: "nbs"、region）：全国月度和季度序列，以及省级横截面数据。data_as_of 是最新有值的统计期。
• 中国海关总署 — 月度进出口总额（china_macro_indicator({ indicator: "trade" })）。
• 中国外汇交易中心 / 全国银行间同业拆借中心 — SHIBOR 定盘利率和中国国债收益率（china_rates）。

LPR 发布方仅提供滚动约 12 个月的数据窗口，因此 china_lpr 无法返回更早的历史数据。LPR 每月 20 日（或下一个工作日）公布，因此 china_lpr_latest 的 reference_date 预计大约每月更新一次。

NBS 和海关数据经由一个无需密钥的再发布方（Eastmoney 数据中心）提供给我们，该平台承载官方数据序列；每个响应的 source 字段中，NBS 或海关的名称始终排在首位，中间平台排在第二位。1 年期 / 10 年期国债基准收益率是根据 IMF 的特殊数据公布标准披露的日度序列；此处每次调用最多返回 60 行，因此请将 periods 设为接近所需数量，而不是日度最大值。实时收益率曲线默认使用国债数据。

快速开始

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

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

此端点实际提供的内容

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

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-china-macro

它通过 stdin/stdout 使用 MCP 协议通信，并针对仅此工具包的工具响应 initialize / tools/list / tools/call——不包含上述网关连接额外提供的任何共享元工具。数据源和工具相同，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

无需直接调用工具，你可以用通俗的英语提问—— 这在上方的 pack 端点和完整网关上都适用：

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT