Stat Xplore MCP

Stat Xplore MCP

MCP服务器，用于查询DWP Stat Xplore福利统计数据。

Claude代码设置

claude mcp add stat-xplore -- uvx --from git+https://github.com/PolicyEngine/stat-xplore-mcp stat-xplore-mcp

首次使用时，系统将提示您输入API密钥。从以下位置获取一个 状态 在账户>开放数据API访问下。

API密钥存储在 ~/.config/stat-xplore-mcp/config.json。您也可以通过设置 STAT_XPLORE_API_KEY 环境变量。

工具

• list_databases -列出所有118个福利数据集（UC、PIP、ESA等）
• get_database_schema -获取数据库的字段和度量值
• query_table -查询统计数据，完全支持维度、重新编码和统计功能
• browse_schema -浏览架构层次结构
• get_rate_limit -检查API费率限制状态

查询示例

基本计数查询

{
  "database": "str:database:HBAI",
  "measures": ["str:count:HBAI:V_F_HBAI"],
  "dimensions": [["str:field:HBAI:V_F_HBAI:YEAR"]]
}

收入中位数查询

对于中值/均值计算，使用具有以下模式的统计函数度量： str:statfn:{database}:{view}:{measure}:{MEDIAN|MEAN}

{
  "database": "str:database:HBAI",
  "measures": [
    "str:statfn:HBAI:V_F_HBAI:S_OE_BHC:MEDIAN",
    "str:statfn:HBAI:V_F_HBAI:S_OE_AHC:MEDIAN"
  ],
  "dimensions": [
    ["str:field:HBAI:V_F_HBAI:YEAR"],
    ["str:field:HBAI:V_F_HBAI:KIDECOBU_WORK"]
  ],
  "recodes": {
    "str:field:HBAI:V_F_HBAI:YEAR": {
      "map": [
        ["str:value:HBAI:V_F_HBAI:YEAR:C_HBAI_YEAR:2223"],
        ["str:value:HBAI:V_F_HBAI:YEAR:C_HBAI_YEAR:2324"]
      ]
    },
    "str:field:HBAI:V_F_HBAI:KIDECOBU_WORK": {
      "map": [
        ["str:value:HBAI:V_F_HBAI:KIDECOBU_WORK:C_HBAI_KIDECOBU_WORK:1"]
      ]
    }
  }
}

重新编码结构

重新编码过滤器和组值：

• map：值组列表。每个内部数组变成一行/一列。同一数组中的多个值被组合在一起。
• total：设置为 true 以包括总行/列。

{
  "str:field:HBAI:V_F_HBAI:NEWFAMBU": {
    "map": [
      ["str:value:...:1"],
      ["str:value:...:2", "str:value:...:3"]
    ],
    "total": true
  }
}