MCP Cbs Cijfers Open Data

🚀 mcp-cbs-cijfers-open-data プロジェクト

このプロジェクトは、モデルコンテキストプロトコル (MCP) 用のサーバーを提供し、CBS オープンデータ API との連携を可能にします。これにより、AI ツールは MCP ツールを通じて CBS オープンデータとやり取りすることができます。

🚀 クイックスタート

このプロジェクトは、CBS オープンデータ API と MCP を介して AI ツールが連携できるようにするサーバーを提供します。以下のセクションでは、その主な機能や使用方法を説明します。

✨ 主な機能

• モデルコンテキストプロトコル (MCP) サーバーを実装しています。
• CBS データとのやり取りに必要なツールを提供します：
  • 利用可能なデータセットとカタログを一覧表示します。
  • データセットのメタデータと次元を照会します。
  • フィルタオプションを使用して統計データを取得します。
  • 次元値を探索します。

📚 ドキュメント

この MCP サーバーは、AI アシスタントが CBS オープンデータ API を介してやり取りするための以下のツールを提供します。

get_catalogs

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

パラメータ:

• なし

query_datasets

CBS オープンデータ 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 パラメータ

query_measure_values

特定の測定値を照会します。

パラメータ:

• catalog（必須）：カタログ識別子
• dataset（必須）：データセット識別子
• measure（必須）：測定値識別子
• select（オプション）：特定のフィールドを選択するための OData $select パラメータ

🔧 技術詳細

• Go 言語バージョン 1.20 以上が必要です。

📦 インストール

プロジェクトを go.mod に追加するには：

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

または、ソースコードからコンパイルするには：

git clone https://github.com/dstotijn/mcp-cbs-cijfers-open-data.git
cd mcp-cbs-cijfers-open-data/
go build -o bin/mcp-cbs-cijfers-open-data .

💻 使用例

基本的な使用法

go run を使用する場合、CLI ツールは bin/ ディレクトリに生成されます。

./bin/mcp-cbs-cijfers-open-data --help

プロジェクトのURL

• GitHub
• Go Module

📄 ライセンス

© 2025 David Stotijn — このプロジェクトは Apache License 2.0 の下で公開されています。