Gastat

@pipeworx/gastat

沙特阿拉伯官方统计数据 — GASTAT（统计总局） 人口、就业／失业、GDP、消费价格和贸易 指标，每个指标 ID 下均同时提供阿拉伯语和英语标题。

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

工具

• gastat_headline() — 快速查看 GASTAT 自有主页指标 （人口、GDP、失业率、增长率、人均收入）。
• gastat_search(term, limit?) — 在约 2,600 个指标中按英语或 阿拉伯语关键词查找；返回指标 ID 和双语标题。
• gastat_series(indicator_id, recent?) — 获取某个指标 ID 的完整时间序列 （来自 gastat_search / gastat_headline）— 提供多个时期的数据， 便于比较随时间的变化，而不只是查询最新值。

身份验证

无需密钥。这里的所有端点均可供匿名访客访问，无需登录、 令牌或注册 — 已通过实时验证。

数据来源

• https://database.stats.gov.sa/gastatapi/portal/api/v1/indicators/cardsinfo — 首页指标（人口、GDP、失业率等）。
• https://database.stats.gov.sa/gastatapi/portal/api/v1/indicators/public — 完整指标目录（约 2,600 个 REP 节点），约 4.5 MB，不支持服务端 过滤。这是 GASTAT 自有 Angular 应用（database.stats.gov.sa） 获取并在客户端搜索的同一个端点；没有公开的开发者门户，因此这是通过 阅读应用自身的 JS 包发现的，而非来自任何已发布的 API 文档。gastat_search 和 gastat_series 每次调用都会重新获取该目录（没有可用的跨请求缓存， 除非有绑定）— 预计会有几秒延迟，这是 GASTAT 的特性，并非我们造成的。
• https://database.stats.gov.sa/gastatapi/portal/api/v1/indicators/getDataForChart?api=<token> — 某个指标的实际观测数据，其中 <token> 是该指标目录条目中携带的 不透明 api_url 字段（测试中多次获取均保持稳定，不与会话绑定）。

注意事项： 大多数目录条目带有简短标题和 api_url 令牌，无需额外参数即可正常解析。少数但数量可观的条目 — 标题中包含按地区、国籍、行业或商品细分的数据 — 需要此端点无法通过普通 GET 请求传递的维度筛选条件，因此会返回 HTTP 400，或返回一行全为 null 的值。gastat_series 会检测这两种情况，并返回清晰的 error/message，而不是暴露原始错误；gastat_search 会优先排列标题中不含细分提示的指标，因为这些指标可以正常解析。

双语注意事项： GASTAT 将所有内容按阿拉伯语和英语标题编入同一个指标 ID — 同一序列绝不会有两个 ID。这里的每个工具都会在同一条记录中保留 title_en 和 title_ar，而不会将阿拉伯语条目视为单独实体。

GASTAT 自有 WAF 会拒绝 indicators/public 上的查询字符串参数（例如 ?term=）— 已通过实时验证。该端点不支持服务端搜索；必须获取整个目录并在客户端过滤，gastat_search 正是这样做的。

快速开始

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

{
  "mcpServers": {
    "gastat": {
      "url": "https://gateway.pipeworx.io/gastat/mcp"
    }
  }
}

此端点实际提供的内容

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

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

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

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

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

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

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

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

npx -y @pipeworx/mcp-gastat

它通过 stdin/stdout 使用 MCP 通信，并为仅属于此套件的工具响应 initialize/tools/list/tools/call——不包含上方网关连接提供的任何共享元工具。来源相同、工具相同，但不支持 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用日常语言提问，而不是直接调用工具——此功能既适用于上方的套件端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Gastat data" })

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

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT