azstat

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が提供する言語はこの2つのみです。タイトル、カテゴリ、検索語句は指定した言語になります。アクセント記号は無視されるため、gelirでgəlirが見つかります。
• データはロング形式で、期間とカテゴリの組み合わせごとに1行です。columnsは各セルの名前を示します。period、次元ごとの列、valueに加え、行に含まれる場合はsymbolとunitがあります。期間は年なら2023、月なら202603のように表記されます。ネストされたカテゴリはparent > childの形式です。
• symbolを伴うnull値（確認された記号は-と...）は、委員会が数値の代わりに記号を公開したことを示します。記号は解釈を加えず、公開されたとおりに返されます。多くの表では、単位はタイトルにしか記載されていません。
• APIにはフィルターがないため、表全体を読み込んでから、ここで絞り込みます。1表あたり最大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を実行します。

任意の設定を1つ、クライアントの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 ライセンスが付与されています。FAQ（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> です。リクエストは毎秒最大 1 回とし、ネットワークエラーおよび 5xx の場合は 1 回だけ再試行し、403 または 429 の場合は停止します。テーブル一覧は 1 時間、各テーブルは 30 分キャッシュされます。
• 個人データ： ありません。テーブルは集計統計です。
• 発行元への連絡： していません。
• 判断： 利用可。公式の読み取り専用 API です。

非公式プロジェクトであり、国家統計委員会とは提携しておらず、同委員会の承認も受けていません。

tests/fixtures/ には API から取得した実際のレスポンスを一部抜粋したものが保存されています。DT_AA_001 と DT_BE_119 は全体です。