🚀 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 许可证发布。