scb-opendata-mcp

Statistics Sweden（SCB）API 用 MCP サーバー

Statistics Sweden の PxWebApi v2 にアクセスできる FastMCP サーバーです。スウェーデンの雇用、労働コスト、賃金、その他の人口統計データを網羅した統計表を提供します。

特長

• 表の検索：5,155 件の統計表を閲覧、検索できます
• データ取得：任意のフィルタリングを指定して統計データを取得できます
• コードリスト：有効なフィルター値のコードリストにアクセスできます
• 保存済みクエリ：よく使うクエリを保存、取得できます
• ページネーション：大量の結果を効率的に処理できます
• 言語サポート：英語とスウェーデン語に対応しています
• エラー処理：再試行ロジックを備えた堅牢なエラー処理を行います

インストール

前提条件

• Python 3.11 以降
• pip または uv パッケージマネージャー

PyPI からインストール

pip install scb-opendata-mcp

# Or with uv
uvx scb_opendata_mcp

ソースからインストール

# Clone the repository
git clone https://github.com/ashwinvis/scb-opendata-mcp.git
cd scb-opendata-mcp

# Install dependencies
pip install .

# Or with uv
uv sync

使用方法

サーバーの実行

インストール時にパッケージは

scb_opendata_mcp

# Or with uv
uv run scb_opendata_mcp

利用可能なオプションについては、scb_opendata_mcp --help を参照してください。stdio トランスポート機構も利用できます。

フォールバックオプション

uv run fastmcp run src/scb_opendata_mcp/server.py -t http  # HTTP server

一般的なエージェントハーネスの設定

Claude Code

claude mcp add --scope user --transport http scb_opendata_mcp http://localhost:6767

Mistral Vibe

~/.vibe/config.toml または ~/.vibe/agents/name_of_agent.toml に記述します。

[[mcp_servers]]
name = "scb_opendata_mcp"
transport = "http"
url = "http://localhost:6767/mcp"

OpenCode

~/.config/opencode/opencode.jsonc に記述します。

{
  "mcp": {
    "scb_opendata_mcp": {
      "type": "remote",
      "url": "https://localhost:6767/mcp",
      "enabled": true
    }
  }
}

利用可能なツール

表の検索

• list_tables() - ページネーションを使って、利用可能なすべての統計表を一覧表示します
• get_table_metadata(table_id) - 変数を含む詳細なメタデータを取得します
• search_tables(query) - 表の名前または説明で検索するための、list_tables の便利なラッパーです

データ取得

• get_table_data(table_id, filters) - 任意のフィルタリングを指定してデータを取得します
• get_table_default_selection(table_id) - 表のデフォルトのデータ選択を取得します

コードリストツール

• list_codelists(table_id) - 表で利用可能なすべてのコードリストを一覧表示します
• get_codelist(codelist_id) - 指定したコードリストの詳細を取得します

保存済みクエリツール

• get_saved_query(query_id) - データと選択条件を含む保存済みクエリを取得します
• get_saved_query_data(query_id) - 指定した保存済みクエリのデータを取得します
• get_saved_query_selection(query_id) - 指定した保存済みクエリで使用された選択クエリを取得します
• save_query(table_id, selection) - データクエリを保存します
• delete_saved_query(query_id) - 保存済みクエリを削除します

開発

テストの実行

uv run pytest

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス

サポート

問題や質問がある場合：

• OpenAPI 仕様を確認するか、代わりに https://github.com/PxTools/PxApiSpecs/blob/master/PxAPI-2.yml をご覧ください。
• Statistics Sweden の API ドキュメントをご覧ください：
  • スウェーデン語：https://www.scb.se/vara-tjanster/oppna-data/pxwebapi/pxwebapi-v2/
  • 英語：https://www.scb.se/en/services/open-data-api/pxwebapi/

SCB Open Data Skills

これは、MCP サーバーを通じて Statistics Sweden のデータにアクセスするためのスキル定義を提供する、非公式の関連リポジトリ SCB Open Data Skills です。これらのスキルは、主要なコーディングエージェントツールで利用でき、さまざまな統計分野のワークフローを提供します。

免責事項

これは非公式のツールです。コードは、公式ドキュメントと API 仕様をコンテキストとして使用し、AI によって生成されました。 機能を検証するテストも追加されています。重要なアプリケーションで使用する前に、綿密かつ厳格な検証テストを実施することを推奨します。