Macau Amcm

@pipeworx/macau-amcm

来自 AMCM（澳门金融管理局，Autoridade Monetária de Macau / 澳門金融管理局）的澳门金融数据：澳门元（MOP）兑约 17 种货币的每日银行间外汇中间价，以及 MONIA——澳门元隔夜银行间参考利率指数。

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

工具

• macau_fx_rates({ begin?, end?, currency? }) — 按日期列出每种货币在每个澳门营业日的澳门元中间价。默认返回截至最近发布日期的最近 7 天；begin/end 接受 YYYY-MM-DD（每次调用最多约 1 年），currency 按逗号分隔的 ISO 代码筛选（"USD,HKD,CNY"）。
• macau_monia({ begin?, end? }) — 每日 MONIA 定盘利率，以百分比表示，采用相同的日期范围设置。

认证

无需密钥。无需注册、密钥或 Cookie——这些端点与 AMCM 自有利率页面加载表格时使用的 JSON API 相同。

数据源

• https://www.amcm.gov.mo/api/v1.0/cms/financial_info?QueryType=ExchangeRate|Monia&Begin=YYYYMMDD&End=YYYYMMDD
• https://www.amcm.gov.mo/api/v1.0/cms/last_data_date?QueryType=... — 最近发布日期，用于确定默认日期范围（周末和澳门公众假期不发布数据）。

给后来者的注意事项

• usdMean 不是美元汇率。 尽管名称如此，usdMean/usdMeanValue 表示每个货币 unit 的澳门元中间价——USD 行本身约为 8.08（每美元对应的澳门元），HKD 行约为 1.03（澳门元与港元的挂钩汇率）。已于 2026-09-07 通过实时数据验证。此工具将其作为 mop_per_unit 提供。
• JPY 和 KRW 的报价单位 unit = 100， 其他货币均为 1。跨货币比较前请先查看 unit 字段。
• bid 的含义因行而异。 它是各货币市场惯例中的第二种报价：EUR/GBP/AUD/NZD 为每单位货币对应的美元，JPY/CHF/SGD/SEK/NOK 等为每美元对应的货币单位，CNY 为每 100 美元对应的人民币，USD 行则为 USD/HKD。该字段以 market_quote 提供，并附有此说明——凡是以澳门元计价的用途，请使用 mop_per_unit。
• 外汇列表包含一行 unit: 0 的 LIQ， 这是 AMCM 的流动性指标，并非货币。外汇工具会将其过滤掉。
• 日期范围内没有数据很正常，并不代表出错：AMCM 仅在澳门营业日发布数据，因此仅涵盖周末或假期的日期范围会返回 0 行。工具会检测这种情况，查询 last_data_date，并在响应中返回该日期，以便调用方重新使用有效日期查询。
• 早前的 china-vertical 探测（fleet #1311）误以为 AMCM 只能下载 XLS；该网站自有页面实际使用的是上面的 JSON API，无需抓取网页。

快速开始

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

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

此端点实际提供的内容

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

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-macau-amcm

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

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——上面的工具包端点和完整网关都支持此功能：

ask_pipeworx({ question: "your question about Macau Amcm data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT