Hk Stocks

@pipeworx/hk-stocks

实时香港股票市场数据——涵盖完整的恒生指数系列和港交所实时股票报价，并提供名称→代码解析器，返回实际股票而非认股权证。

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

工具

• hk_market_snapshot() — HSI（恒生指数）、HSCEI（恒生中国企业指数，即 H 股）、HSTECH（恒生科技指数）、HSCCI（恒生香港中资企业指数，即红筹股）和 VHSI（恒指波幅指数，即波动率）的收盘点位、涨跌、涨跌幅、日内区间和 52 周区间。回答“香港股市收盘表现如何”。
• hk_quote({ codes }) — 按港交所代码查询实时行情。包含中英文名称、价格、涨跌、开盘价/前收盘价、日内最高/最低价、成交股数、港元成交额、市盈率和 52 周区间。接受 700、00700、0700.HK、HK:700。
• hk_resolve_symbol({ name }) — 公司名称 → 港交所代码。支持英文和中文输入。

身份验证

无需密钥。两个上游服务均公开且无需身份验证；无需注册，也无需协商配额。

数据源

• https://hq.sinajs.cn/list=rt_hkHSI,rt_hk00700 — 指数点位和股票行情。采用 GBK 编码，而非 UTF-8——请从原始字节解码（new TextDecoder('gbk')），否则所有中文名称都会变成乱码。
• https://suggest3.sinajs.cn/suggest/type=31&key=腾讯 — 解析中文输入的名称→代码。
• https://query1.finance.yahoo.com/v1/finance/search?q=tencent — 解析拉丁字母输入的名称→代码。

值得注意，避免重复踩坑

两个解析器上游都不同时支持两种文字，这就是需要两个解析器的原因。

• Yahoo 会直接拒绝非 ASCII 输入——q=小米 返回 HTTP 400，而非空结果集，因此它完全无法处理中文查询。
• 对于拉丁字母输入，Sina 的港股搜索会返回认股权证索引。 key=tencent 返回 TENCENT N4104、TENCENT N6006、TENCENT N3606-R ……却从不返回 00700。对于中文输入（key=腾讯），同一端点会把实际股票排在首位。因此，中文使用 Sina，拉丁字母使用 Yahoo；若 Yahoo 无结果，则回退到 Sina。

港交所代码范围可用于筛选。 股票和 GEM 代码低于 10000；10000–69999 为衍生权证和牛熊证；80000 以上为双柜台股票的人民币柜台（80700 是腾讯的人民币柜台代码，而非其港元股票代码）。这两类代码看起来都像是“腾讯的港股代码”，因此使用单一的 < 10000 阈值即可排除它们。

有意不返回指数的成交额/成交量。 对于股票，Sina 将字段 11/12 填为港元成交额和成交股数——这点可以验证：36,203,193 股 × 约 HK$462，与其报告的 HK$16.76bn 成交额相符。而在指数行中，这些字段表示其他数据：HSI 返回 312,233,275 和 14,192,915,767，两者都无法与已知的港交所每日市场成交额相符。我们不会给无法核实的数字贴上错误标签，因此快照会省略这些数据并说明原因。hk_quote 返回的个股成交额是可靠的。

缺失的上市代码会返回空内容，而非错误。 对于未知代码，Sina 会返回 var hq_str_rt_hk99999="";——HTTP 200。调用方必须将空字段列表视为未找到；否则，不存在的股票会悄然变成价格为 null 的行情。

快速开始

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

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/hk-stocks/mcp 返回上表中的工具，以及 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/hk_market_snapshot \
  -H 'Content-Type: application/json' \
  -d '{}'

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

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

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

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

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-hk-stocks

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Hk Stocks data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT