MCP Cbs Cijfers Open Data

🚀 mcp-cbs-cijfers-open-data 項目

本項目為 模型上下文協議 (MCP) 搭建了一個服務器，用於連接 CBS 開放數據 API。藉助該服務器，AI 工具能夠通過 MCP 與 CBS 開放數據實現交互，為數據獲取和處理提供便利。

🚀 快速開始

本項目為 AI 工具與 CBS 開放數據的交互提供了支持。你可以通過安裝項目並使用提供的工具，實現對 CBS 開放數據的查詢和獲取。

✨ 主要特性

• 實現了一個 模型上下文協議 (MCP) 服務器，為 AI 工具與 CBS 開放數據的交互提供基礎支撐。
• 提供了一系列與 CBS 數據交互的工具：
  • 可列出可用的數據集和目錄，方便用戶快速瞭解數據範圍。
  • 能查詢數據集元數據和維度，幫助用戶深入瞭解數據特徵。
  • 支持使用過濾選項檢索統計數據，提高數據獲取的精準度。
  • 允許探索維度值，挖掘數據的潛在信息。

📦 安裝指南

方式一：添加到 go.mod

將項目添加到 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

📚 詳細文檔

此 MCP 服務器提供了以下工具，用於 AI 助手通過 CBS 開放數據 API 進行交互：

get_catalogs

獲取所有可用的 CBS 數據目錄。 參數：無

query_datasets

列出 CBS 開放數據 API 中可用的數據集，具有高級過濾、排序和分頁選項。 參數：

• catalog（必需）：目錄標識符（使用 "CBS"）
• select（可選）：OData $選擇參數以選擇特定字段
• filter（可選）：OData $過濾參數用於篩選結果
• orderby（可選）：OData $排序參數用於排序結果
• 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 $選擇參數以選擇特定字段

query_measure_values

查詢特定度量的值。 參數：

• catalog（必需）：目錄標識符
• dataset（必需）：數據集標識符
• measure（必需）：度量標識符
• select（可選）：OData $選擇參數以選擇特定字段

🔧 技術細節

• 語言要求：需要 Go 語言版本 1.20 或更高。

📄 許可證

本項目根據 Apache License 2.0 許可證發佈。

項目地址

• GitHub
• Go Module