🚀 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