azstat

Name: azstat
Author: azerbaijan-mcp

本地服务

github.com/azerbaijan-mcp法律与政务13 天前更新

代码仓库

关于 azstat

azstat 是面向阿塞拜疆国家统计委员会开放数据 API 的 MCP 服务，可搜索统计表并读取表格数据。它适合查询人口、劳动力、教育、价格和贸易等官方汇总统计。

主要功能

01浏览统计主题及表格数量
02按标题和主题搜索表格
03查看表格维度、时期和单位
04筛选并分页读取表格数据

适用场景

01查找阿塞拜疆人口统计数据
02筛选特定年份的指标数值
03检查统计表的类别和单位

MCP 相关

该服务向 MCP 客户端提供主题列表、表格搜索与描述、数据读取工具，通过委员会开放数据 API 获取内容。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "azerbaijan-mcp-azstat": {
      "command": "uvx",
      "args": [
        "azerbaijan-mcp-azstat"
      ]
    }
  }
}

启动命令uvx azerbaijan-mcp-azstat

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiazerbaijan-mcp-azstat0.1.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

azerbaijan-mcp-azstat

面向阿塞拜疆国家统计委员会（azstat.gov.az）的 MCP 服务。它可搜索该委员会的统计表（31 个主题中约有 1,800 张表，涵盖人口、劳动力市场、教育、价格、贸易等），并通过该委员会的开放数据 API 读取数据：无需 API 密钥，也不抓取网页。

工具

工具	功能
`list_topics(lang?)`	列出 31 个主题及其表格数量。
`search_tables(query?, topic?, limit?, offset?, lang?)`	搜索表格标题和说明。查询中的每个词都必须出现，标题匹配项优先。不提供查询时，则列出指定主题的表格。
`describe_table(table_id, category_query?, lang?)`	查看表格内容：说明、时期、单位和各维度的类别。`category_query` 可查找确切的类别名称。
`get_table_data(table_id, period_from?, period_to?, where?, limit?, offset?, lang?)`	以长格式返回行。`where` 用于筛选类别，例如 `{"Indicator": "Total population"}`。`limit` 为 1–500（默认值为 50），可通过 `next_offset` 获取后续页。

例如，要查询“2023 年阿塞拜疆的人口是多少？”，可依次调用 search_tables("population")、 describe_table("DT_AA_001")，然后调用 get_table_data("DT_AA_001", period_from=2023, where={"Indicator": "Total population"})。

值得注意的事项：

lang 可设为 en 或 az；API 不提供其他语言。标题、类别和搜索词都使用该语言。搜索时会忽略重音符号，因此 gelir 可以匹配 gəlir。
数据采用长格式，每种时期和类别组合占一行。columns 列出各单元格的名称：period、每个维度各一列、value，以及在行中存在时的 symbol 和 unit。年份写作 2023，月份写作 202603。嵌套类别的格式为 parent > child。
带有 symbol 的 null 值（已见：- 和 ...）表示委员会发布的是符号而非数值。符号会按发布内容原样返回，不作解释。许多表格只在标题中注明单位。
API 不支持筛选，因此会读取整张表，再在此处截取。每张表最多读取 20 MB（更大的表会返回 status too_large），并缓存 30 分钟。抽查过的表格中，最大的一张为 9 MB。
有些表格似乎缺少一个维度。在抽查的 26 张表格中，有 2 张在相同期和类别下包含多个值，却没有信息可用于区分这些值。对于这些表格，get_table_data 会返回 status ambiguous，不返回任何行，并附上该表在委员会网站上的链接；describe_table 仍会显示其内容。

安装

将以下内容添加到 MCP 客户端配置中（需要 uv）：

{
  "mcpServers": {
    "azstat": {
      "command": "uvx",
      "args": ["azerbaijan-mcp-azstat"]
    }
  }
}

在 Claude Code 中：claude mcp add azstat -- uvx azerbaijan-mcp-azstat。

可选设置只有一项，添加到客户端的 env 中：

变量	默认值	含义
`AZSTAT_API_BASE`	`https://www.azstat.gov.az/AsisOpenDataApi`	API 基础 URL，仅支持 https。

数据源和条款

数据由国家统计委员会发布，网址为 https://www.azstat.gov.az。此服务读取其开放数据 API 中 AsisOpenDataApi 的 tables 和 data 操作。该 API 没有公开文档（常见路径下均无文档页面），因此通过实时合约测试固定其响应格式。以下是对仓库数据政策中检查清单的答复，查阅日期为 2026-11-01：

**条款：**委员会自己的页面未说明 API 的使用条款，并要求用户注明来源。国家开放数据门户 opendata.az 在其 1,662 个数据集中，有 1,426 个数据集的文件列表中包含 AsisOpenDataApi 地址，且全部 1,662 个数据集均采用 CC0 许可。其常见问题解答（https://opendata.az/page/faq，更新于 2025 年 4 月 8 日）将开放数据定义为任何人均可访问、使用和再次分享的数据，并告知开发者可以基于这些数据和 API 构建应用。
**robots.txt：**未发布（www.azstat.gov.az/robots.txt 返回 404）。
**署名：**每个响应都包含 source 和 attribution 字段，以及表格页面的链接。使用数据时请注明委员会为来源。
**速率限制和缓存：**User-Agent 为 azerbaijan-mcp-azstat/<version>，每秒最多发送一个请求；网络错误和 5xx 错误时重试一次；遇到 403 或 429 时停止。表格列表缓存一小时，每张表缓存 30 分钟。
**个人数据：**无。表格均为汇总统计数据。
**是否联系发布方：**否。
**决定：**可以使用，这是一个官方只读 API。