Macau Stats

@pipeworx/macau-stats

澳门（澳门特别行政区）官方统计数据——来自 DSEC（澳门统计暨普查局 / Direcção dos Serviços de Estatística e Censos）的 143 项主要指标（人口、访客入境人数、博彩收入、CPI、失业率、出生人数／死亡人数等）。

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

工具

• macau_indicators({ query? }) — 列出全部 143 项关键指标 （id、英文／中文／葡萄牙语名称、报告频率）。传入 query 可按任一语言中的关键词筛选。
• macau_indicator({ id?, name?, periods? }) — 按数字 id 或名称／关键词查询一项指标的最新值；若能在 DSEC 的综合统计数据库中找到可靠匹配项，还会返回历史序列（参见下文的 ID 空间说明）。periods 默认为 24。
• macau_gaming_revenue() — 澳门每月博彩毛收入（澳門博彩毛收入），单位为百万 MOP——与博彩监管机构 DICJ 发布在 HTML 表格中的数据相同，但此处以结构化数据提供。
• macau_population() — 常住人口总数，按季度统计。
• macau_tourism() — 访客入境人数，按月统计。
• macau_employment() — 一次调用即可查询失业率、就业总人数和月收入中位数。

身份验证

无需密钥。无需注册，也无需 API 密钥，尽管 DSEC 的 /zh-MO/Service/WebService 页面介绍了一款“请联系我们”式的嵌入组件产品——该说明针对的是品牌化嵌入组件，而非此处使用的原始数据调用。

数据源

• https://www.dsec.gov.mo/TimeSeriesDatabase.asmx — DSEC 的公开 SOAP Web 服务（WSDL 位于 ?WSDL）。这是较老式的 ASP.NET ASMX：每个 SOAP 操作也支持普通 HTTP GET（框架的 HttpGet 绑定），因此此数据包使用 GET + 查询字符串调用，并解析 XML 响应——无需 SOAP 信封。

后续使用者需注意的问题

• 存在两个互不相通的 id 空间。 143 个精选 KeyIndicatorID （getKeyIndicatorList/getKeyIndicatorValue）与综合目录中的 IndicatorID 编号体系（getIndicatorID/getIndicatorByID/ getIndicatorLatestNValues）并不相同——对 KeyIndicatorID 15 调用 getIndicatorByID(15) 会返回空结果。没有文档记录的映射表。此数据包会在综合目录中搜索与关键指标自身名称相匹配的描述，从而解析映射；只有在恰好匹配到一个序列时才采信该结果（匹配不明确或为空表示“没有可靠历史数据”，而不是猜测）——已确认“活产”对应 IndicatorID 9014；已确认“博彩毛收入”没有匹配项（该指标仅存在于精选关键指标集合中，不在综合目录中）。
• 精选关键指标端点（getKeyIndicatorValue）仅返回最新值——没有期数参数，也不提供历史数据。要获取实时序列，必须使用上文所述的综合目录映射，但并非每项指标都能解析出映射。
• 图表操作（getChart、getCommonChart）返回 base64 编码的 PNG 图像（ChartData），而非结构化数字——不适用于数据 API，因此此数据包不会调用它们。
• 语言枚举值：English、TraditionalChinese、 SimplifiedChinese、Portuguese——不是 Chinese（该值会因 .NET 转换错误而返回 500）。
• 此数据包取代了对 DICJ（博彩监管机构）HTML 表格的抓取——此处可通过清晰的 XML 获取相同的博彩月毛收入数据。

快速开始

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

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/macau-stats/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_indicators \
  -H 'Content-Type: application/json' \
  -d '{}'

首次调用无需账号。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/macau_indicators。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

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

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

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

npx -y @pipeworx/mcp-macau-stats

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

使用 ask_pipeworx

你可以不用直接调用工具，而是用自然语言提问——此方式既适用于上述工具包端点，也适用于完整网关：

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

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

更多内容

• 文档和指南
• pipeworx.io

许可证

MIT