statfin-mcp

@nor-data/statfin-mcp

Statistics Finland（Tilastokeskus） の公式統計を提供する StatFin データベース向け MCP サーバーです。PxWeb API を通じて公開されています。3000 以上のテーブルを検索し、各テーブルの次元を確認して、データを JSON-stat2 として取得できます。API キーは不要です。

北欧のオープンデータ向け MCP サーバー群 nor-data の一部です。SSB（ノルウェー）サーバーと同じ方式で構築されています。StatFin と SSB はどちらも PxWeb を使用するため、ツールの構成も共通しています。

ツール

ツール	機能
sok_tabell	StatFin の全テーブルをキーワード検索します。PxWeb はサーバー側の検索に対応していないため、ローカルで 同梱インデックス（テーブルツリー全体から作成）を検索し、最も関連性の高いテーブルと tabell_id を返します。
hent_tabell	テーブルのメタデータを取得します。タイトルと、有効な値コードおよびラベルを含む次元（変数）が返されます。まずこれを読み、使用可能なフィルターコードを確認してください。
hent_data	実際の値を JSON-stat2 として取得します。フラットな {variabelkode: [verdier]} マップで絞り込めます。最新の期間を指定する {filter:'top', values:['1']} のような特殊な選択にも対応しています。
list_emner	StatFin の約 140 の主題分野（例：vaerak = 人口構造）を一覧表示します。キーワード検索で見つからない場合に、検索範囲を絞ったり、参照したりできます。

すべてのツールは、オプションの lang（既定値は en、fi、sv も指定可能）を受け付けます。変数の コード は言語に依存しませんが、タイトルとラベルは言語ごとに表示されます。

エージェントの使用例

1. sok_tabell({ query: "population by region" }) → tabell_id: "vaerak/statfin_vaerak_pxt_11ra.px"
2. hent_tabell({ tabell_id }) → 変数 Alue（地域）、Vuosi（年）、Tiedot（情報）を確認します
3. hent_data({ tabell_id, filtre: { Alue: ["SSS"], Vuosi: { filter: "top", values: ["1"] } } }) → 最新の全国値を JSON-stat2 として取得します

インストール

// Claude Desktop / Claude Code MCP config
{
  "mcpServers": {
    "statfin": {
      "command": "npx",
      "args": ["-y", "@nor-data/statfin-mcp"]
    }
  }
}

開発

npm install
npm run build-index   # crawl the StatFin tree → data/tables-index.json (~1–2 min)
npm run dev           # run from source via tsx
npm run build         # compile to dist/

検索インデックスはパッケージに同梱されています（data/tables-index.json）。更新するには npm run build-index を再実行してください（毎晩の更新で十分です。StatFin はテーブルを頻繁に更新しますが、ツリーはあまり更新しません）。

注意事項と制限

• PxWeb は 10 秒あたり 30 回の呼び出しを許可しており、約 100 000 セルを超えるクエリは拒否されます（HTTP 403）。hent_data の選択範囲は小さくしてください（地域と年を少数に絞ります）。
• 一部の主題（vtp、kivih、sekn、akay）はサーバー側で HTTP 400 を返すため、インデックス作成時にスキップされます。これは StatFin の仕様によるもので、このサーバーの不具合ではありません。インデックスでは skipped に記録されます。
• データは Statistics Finland により CC BY 4.0 ライセンスで提供されています。

ライセンス

MIT