关于 Hkma Hk
Hkma Hk 以免密方式提供香港金融管理局公开数据集,适合查询货币及金融统计。除按接口路径获取任意数据集外,还提供银行同业流动性、货币基础、HIBOR 和港元汇率工具。
主要功能
- 01按接口路径获取任意 HKMA 公开数据集
- 02查询每日银行同业流动性数据
- 03查询货币基础组成项目
- 04按期限和日期范围查询 HIBOR
- 05获取港元兑主要货币汇率
适用场景
- 01探索专用工具未覆盖的 HKMA 数据序列
- 02跟踪每日 HIBOR 和银行同业流动性
- 03查看货币基础组成项目的变化
- 04按日期查询港元汇率
MCP 相关
向 MCP 客户端提供 HKMA 数据集获取及便捷查询工具。可通过 Pipeworx 网关使用,也可作为独立 stdio MCP 服务运行。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/hkma-hk/mcpclaude mcp add --transport http pipeworx-io-hkma-hk https://gateway.pipeworx.io/hkma-hk/mcp{"mcpServers":{"pipeworx-io-hkma-hk":{"type":"http","url":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-hkma-hk":{"type":"http","url":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-hkma-hk":{"type":"http","url":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}{"mcpServers":{"pipeworx-io-hkma-hk":{"serverUrl":"https://gateway.pipeworx.io/hkma-hk/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
mcp-hkma-hk
香港金融管理局(HKMA)公共开放 API MCP。无需密钥。
属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1881+ 个实时数据源的 MCP 网关。这是一个独立、非官方的集成,与上游提供方无关联,未获其认可,也未由其发布。
工具
| 工具 | 描述 |
|---|---|
hkma_dataset | 通过端点路径(即 https://api.hkma.gov.hk/public/ 之后的部分)获取任意 HKMA 公共数据集。返回统一的数据结构:数据行位于 result.records 下,总数位于 result.datasize 下。用于获取任何未被便捷工具覆盖的 HKMA 数据序列。已验证的示例路径:"market-data-and-statistics/daily-monetary-statistics/daily-figures-interbank-liquidity"(每日 HIBOR/综合余额/TWI)、"market-data-and-statistics/daily-monetary-statistics/daily-figures-monetary-base"(货币基础组成部分)、"market-data-and-statistics/monthly-statistical-bulletin/er-ir/hk-interbank-ir-daily"(按期限划分的 HIBOR 定盘利率)、"market-data-and-statistics/monthly-statistical-bulletin/er-ir/er-eeri-daily"(港元兑主要货币汇率)、"market-data-and-statistics/monthly-statistical-bulletin/er-ir/hkd-fer-daily"(港元远期点)、"market-data-and-statistics/monthly-statistical-bulletin/er-ir/composite-ir"(综合利率,按月)、"market-data-and-statistics/monthly-statistical-bulletin/banking/customer-deposits-by-currency"、"coin-cart-schedule"(需要 lang)。在 apidocs.hkma.gov.hk 浏览更多数据。日期格式为 YYYY-MM-DD;使用 offset/pagesize 分页。 |
hkma_interbank_liquidity | 每日银行同业流动性数据:隔夜及 1 个月 HIBOR、综合余额(开市/收市)、贴现窗基本利率、兑换保证的强方/弱方汇率(7.75/7.85),以及贸易加权指数(TWI)。每个营业日一条记录,最新记录在前。使用 from/to 限定日期范围。 |
hkma_monetary_base | 香港货币基础各组成部分的每日数据:负债证明书、流通中的政府纸币及硬币、综合余额(贴现窗前/后),以及未偿还的外汇基金票据及债券。每个营业日一条记录。使用 from/to 限定日期范围。 |
hkma_interbank_interest_rates | 按期限划分的港元银行同业拆息(HIBOR):隔夜、1 周、1/3/6/9/12 个月;每天(end_of_day)一条记录。数据源为《每月统计公报》的 er-ir 数据序列。使用 from/to 限定日期范围。 |
hkma_exchange_rates | 港元兑主要货币的市场汇率(USD、GBP、JPY、CNY、EUR、AUD、CAD、SGD 等),每天(end_of_day)一条记录。数据源为《每月统计公报》的 er-ir er-eeri-daily 数据序列。使用 from/to 限定日期范围。 |
快速开始
添加到你的 MCP 客户端(Claude Desktop、Cursor、Windsurf 等):
{
"mcpServers": {
"hkma-hk": {
"url": "https://gateway.pipeworx.io/hkma-hk/mcp"
}
}
}
此端点实际提供的内容
https://gateway.pipeworx.io/hkma-hk/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/hkma_dataset \
-H 'Content-Type: application/json' \
-d '{"path":"market-data-and-statistics/daily-monetary-statistics/daily-figures-interbank-liquidity"}'
首次调用无需账号。查看任意工具:GET https://gateway.pipeworx.io/v1/tools/hkma_dataset。查找工具:使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。
独立运行(无需网关账号)
此软件包也可以作为本地 stdio MCP 服务运行,无需 Pipeworx 账号,也无需通过网关往返:
{
"mcpServers": {
"hkma-hk": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-hkma-hk"]
}
}
}
也可以直接运行,确认服务能够启动:
npx -y @pipeworx/mcp-hkma-hk
它通过 stdin/stdout 使用 MCP 通信,并为仅限此工具包的工具响应 initialize/tools/list/tools/call——不包含上文网关连接额外提供的任何共享元工具。数据源相同,工具相同,但没有 ask_pipeworx 路由。
使用 ask_pipeworx
你也可以用自然语言提问,而不是直接调用工具——此方式既适用于上文的工具包端点,也适用于完整网关:
ask_pipeworx({ question: "your question about Hkma Hk data" })
网关会选择合适的工具,并自动填入参数。
更多内容
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。