Istat It

mcp-istat-it

ISTAT（Istituto Nazionale di Statistica）MCP — 公開 SDMX 2.1 REST ウェブサービスを通じたイタリアの国家統計です。認証や API キーは不要です。

Pipeworx の一部です — AI エージェントを1882以上の稼働中データソースにつなぐ MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

ツール	説明
list_dataflows	ISTAT のデータセット（データフロー）を閲覧、またはキーワードで検索します。各結果には、get_data／dataflow_structure に渡す id（dataflowId）と英語名が含まれます。ISTAT は約4,800件のデータセットを公開しているため、全件表示したい場合を除き、必ず query を渡して絞り込んでください。例：list_dataflows({ query: "unemployment" }) または list_dataflows({ query: "GDP" })。
dataflow_structure	ISTAT のデータセット1件の構造（Data Structure Definition）を取得します。順序付きのディメンションと、それぞれで有効なコードがわかります。これを使って、get_data 用のドット区切り SDMX キーを組み立てます。キーの各位置は順番にディメンションに対応し、空の位置はワイルドカードになります。例：dataflow_structure({ dataflow_id: "101_1015" })。
get_data	ISTAT のデータセットから観測値を取得します。key はドット区切りの SDMX ディメンションフィルターで、dataflow_structure で示される順序に従い、ディメンションごとに1つの位置を指定します。位置を空にすると、そのディメンションはワイルドカードになります。例：get_data({ dataflow_id: "101_1015", key: "A.IT...", start_period: "2021", end_period: "2023" }) は、年次（A）、REF_AREA=IT（イタリア）を選択し、残りをワイルドカードにします。key を省略する（または "" を渡す）と、すべての系列を取得します。大量になる場合があるためご注意ください。ディメンションのラベルと期間ごとの値を含む、デコード済みの系列を返します。

クイックスタート

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

{
  "mcpServers": {
    "istat-it": {
      "url": "https://gateway.pipeworx.io/istat-it/mcp"
    }
  }
}

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

https://gateway.pipeworx.io/istat-it/mcp の tools/list は、上の表にあるツールに加えて、共通の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall、その他ゲートウェイ全体で利用できるツール）も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック固有のツールとともに、共通ツールが約30件表示されます。接続時の initialize の応答に正確な対象範囲が示され、これはその日の情報として最も信頼できる回答です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うことで、このパックでは扱えない質問にも、カタログ全体から振り分ける ask_pipeworx を通じて回答できます。そのために2つ目の MCP サーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、振り分け機能の利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

このパックだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx のフルゲートウェイに接続してください。

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

どちらの URL も同じゲートウェイと同じ1882以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらから接続しても、ask_pipeworx ですべてのツールにアクセスできます。

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

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

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

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

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへのラウンドトリップも不要です。

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

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

npx -y @pipeworx/mcp-istat-it

stdin/stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じデータソース、同じツールを利用できますが、ask_pipeworx による振り分けはありません。

ask_pipeworx での使用

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

ask_pipeworx({ question: "your question about Istat It data" })

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

詳細

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

ライセンス

MIT