Estat Japan

@pipeworx/estat-japan

e-Stat（日本）MCP — 人口、経済、労働、貿易、物価、農業、環境を網羅する、日本政府統計の集約サービス（約5000の表）。アプリ ID があれば無料で利用できます。

Pipeworx の一部です — AI エージェントを1684以上のライブデータソースに接続する MCP ゲートウェイです。

ツール

• search_stats(query, limit?, start_position?, lang?) — 統計表を検索します
• get_metadata(stats_data_id, lang?) — 表の次元とコードリストを取得します
• get_data(stats_data_id, limit?, start_position?, lang?, filters?) — 観測値を取得します
• list_data_catalog(query?, limit?, start_position?, lang?, data_type?, survey_years?, stats_code?, stats_field?) — カタログを閲覧します

認証

• プラットフォームキー： ゲートウェイ環境変数 PLATFORM_ESTAT_KEY（e-stat.go.jp が発行する appId）
• BYO： https://www.e-stat.go.jp/api/ で登録後、?_apiKey=<appId> を指定します

データソース

https://api.e-stat.go.jp/rest/3.0/app/json/ — クエリパラメーターとして appId を指定します。

デフォルトの言語は日本語（J）です。英語が利用可能な場合は lang: "E" を渡してください。

タイムアウト

e-Stat は応答が遅く、独自のタイムアウトを設定していません。2026-08-27 の測定では、/getStatsList はキャッシュなしで約26秒かかり、/getDataCatalog はページサイズが1、5、20のいずれでもゲートウェイの75秒のリクエスト期限を超過しました。遅さの原因はページサイズではありません。

そのため各リクエストには個別の予算を設定しています。通常は55秒（ゲートウェイ独自の75秒の期限より約20秒短い時間）、list_data_catalog は35秒です。このエンドポイントは遅れて完了するのではなく、まったく完了しないためです。予算を超過すると、処理がハングする代わりにソフトエラーを返します。

{ "found": false, "reason": "upstream_timeout", "endpoint": "...", "timeout_ms": 35000,
  "hint": "... use search_stats ..." }

list_data_catalog の limit はデフォルトで20（get_data は100、search_stats は20）なので、引数なしの呼び出しにもすでに上限が設定されています。カタログが遅い原因はページサイズではありませんでした。カタログでは e-Stat 独自の絞り込みパラメーター（query、data_type、stats_code、survey_years）を使用できます。2026-08-27 の停滞時には、どのパラメーターを指定しても処理時間は短縮されなかったため、解決策ではなくフィルターとして扱ってください。search_stats は同じ表を検索し、終始数秒で応答しました。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "estat-japan": {
      "url": "https://gateway.pipeworx.io/estat-japan/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/estat-japan/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 も、同じゲートウェイと同じ1684以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使って、すべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/search_stats \
  -H 'Content-Type: application/json' \
  -d '{"query":"失業率"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/search_stats を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイ経由の往復通信も不要です。

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

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-estat-japan

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。ただし対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使用し、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは、上記のパックエンドポイントでもフルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Estat Japan data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT