mcp-cbs-cijfers-open-data

mcp-cbs-cijfers-open-data

このプロジェクトは、CBS Open Data API 用の Model Context Protocol（MCP）サーバーを提供します。AI ツールが MCP ツールを通じて CBS Open Data を利用できるようにします。

特長

• Model Context Protocol（MCP）サーバーを実装します
• CBS Open Data を利用するためのツールを提供します：
  • 利用可能なデータセットとカタログを一覧表示します
  • データセットのメタデータとディメンションを照会します
  • フィルタリングオプションを指定して統計データを取得します
  • ディメンションの値を確認します

ツール

この MCP サーバーは、AI アシスタントが CBS Open Data API を利用するための次のツールを提供します：

get_catalogs

利用可能な CBS データカタログをすべて取得します。

パラメーター：

• なし

query_datasets

高度なフィルタリング、並べ替え、ページネーションのオプションを指定して、CBS Open Data API で利用可能なデータセットを一覧表示します。

パラメーター：

• catalog（必須）：カタログ識別子（「CBS」を使用）
• select（任意）：特定のフィールドを選択する OData $select パラメーター
• filter（任意）：結果をフィルタリングする OData $filter パラメーター
• orderby（任意）：結果を並べ替える OData $orderby パラメーター
• top（任意）：結果数を制限する OData $top パラメーター
• skip（任意）：ページネーション用の OData $skip パラメーター
• count（任意）：レスポンスに件数を含める OData $count パラメーター
• search（任意）：全文検索用の OData $search パラメーター
• expand（任意）：関連エンティティを含める OData $expand パラメーター

get_dimensions

指定したデータセットのディメンションをすべて取得します。

パラメーター：

• catalog（必須）：カタログ識別子
• dataset（必須）：データセット識別子

get_dimension_values

フィルタリングと並べ替えのオプションを指定して、特定のディメンションの値をすべて取得します。

パラメーター：

• catalog（必須）：カタログ識別子
• dataset（必須）：データセット識別子
• dimension（必須）：ディメンション識別子
• select（任意）：特定のフィールドを選択する OData $select パラメーター
• filter（任意）：結果をフィルタリングする追加の OData $filter パラメーター
• orderby（任意）：結果を並べ替える OData $orderby パラメーター
• top（任意）：結果数を制限する OData $top パラメーター

get_observations

任意のフィルターを指定して、特定のデータセットから観測値を取得します。

パラメーター：

• catalog（必須）：カタログ識別子
• dataset（必須）：データセット識別子
• filters（任意）：キーと値のペアで指定するフィルター
• limit（任意）：返す観測値の最大数

query_observations

高度な OData クエリオプションを使って観測値を照会し、結果のフィルタリング、並べ替え、形式調整を行います。

パラメーター：

• catalog（必須）：カタログ識別子
• dataset（必須）：データセット識別子
• select（任意）：特定のフィールドを選択する OData $select パラメーター
• filter（任意）：結果をフィルタリングする OData $filter パラメーター
• orderby（任意）：結果を並べ替える OData $orderby パラメーター
• top（任意）：結果数を制限する OData $top パラメーター
• skip（任意）：ページネーション用の OData $skip パラメーター
• count（任意）：レスポンスに件数を含める OData $count パラメーター
• search（任意）：全文検索用の OData $search パラメーター
• expand（任意）：関連エンティティを含める OData $expand パラメーター

get_metadata

CBS API の OData サービスメタデータドキュメントを取得します。

パラメーター：

• なし

要件

• Go 1.24

インストール

一般的な MCP ホスト（Claude Desktop、Cursor）向けの設定：

{
  "mcpServers": {
    "cbs-cijfers-open-data": {
      "command": "go",
      "args": ["run", "github.com/dstotijn/mcp-cbs-cijfers-open-data@latest"]
    }
  }
}

または、Go がインストールされている場合は、プログラムを手動でインストールできます：

go install github.com/dstotijn/mcp-cbs-cijfers-open-data@latest

使用方法

$ mcp-cbs-cijfers-open-data --help

Usage of mcp-cbs-cijfers-open-data:
  -http string
        HTTP listen address for JSON-RPC over HTTP (default ":8080")
  -sse
        Enable SSE transport
  -stdio
        Enable stdio transport (default true)

通常、MCP ホストがプログラムを実行して MCP サーバーを起動するため、手動で実行する必要はありません。ただし、たとえば HTTP（SSE を使用）で提供するために、MCP サーバーを手動で実行する場合は、次のようにします。

PATH 環境変数に、$GOBIN（または $GOBIN が設定されていない場合は $GOPATH/bin、$HOME/go/bin）で指定されるパスが含まれていることを確認してから、次を実行します。

mcp-cbs-cijfers-open-data --stdio=false --sse

SSE トランスポートの URL を含む起動ログが出力されます。

CBS API MCP server started, using transports: [sse]
SSE transport endpoint: http://localhost:8080

---

© 2025 David Stotijn — このプロジェクトは Apache License 2.0 の下でライセンスされています。