Avoindata Fi

mcp-avoindata-fi

Finland Open Data（www.avoindata.fi/data/en）のCKAN MCPです。

Pipeworxの一部です。AIエージェントを1872以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式インテグレーションであり、上流プロバイダーとの提携、承認、公開を受けたものではありません。

ツール

ツール	説明
search_datasets	Finland Open Data（フィンランド）でキーワードを使ってデータセットを検索します。各データセットのid/name、タイトル、組織、およびリソース（それぞれquery_resourceで使用するresource_idを含む）を返します。
dataset	idまたはname（search_datasetsで取得）を指定して、Finland Open Dataのデータセット1件の全メタデータを表示します。すべてのリソースとそのresource_idも含みます。
query_resource	resource_id（データセットのresourcesから取得）を指定して、表形式のFinland Open Dataリソース（CKAN DataStore）から行を取得します。全文検索q、limit、offsetは任意で指定できます。注：クエリ可能なのはDataStoreが有効なリソースのみです。

クイックスタート

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

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

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

https://gateway.pipeworx.io/avoindata-fi/mcpのtools/listは、上の表にあるツールに加えて、共有Pipeworxメタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で利用できるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共有ツールがおよそ30個表示されます。接続のinitializeレスポンスには正確な対象範囲が示され、その日の状況を確認するための正式な情報源となります。

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

また、フルPipeworxゲートウェイに接続すれば、このパックのツールだけでなく、すべてのパックのツールを直接一覧表示できます。

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

どちらのURLも同じゲートウェイと同じ1872以上のデータソースにアクセスします。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでもask_pipeworxを使ってすべてのツールにアクセスできます。

MCPクライアントをお持ちでない場合：HTTPで呼び出す

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

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/avoindata_fi_search_datasetsを実行します。ツールを見つけるには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを実行します。

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

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

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

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

npx -y @pipeworx/mcp-avoindata-fi

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

ask_pipeworxを使用する

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

ask_pipeworx({ question: "your question about Avoindata Fi data" })

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

詳細

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

ライセンス

MIT