mcp-cbs-cijfers-open-data

该项目提供了一个用于CBS 开放数据API的模型上下文协议（MCP）服务器。它允许AI工具通过MCP工具与CBS开放数据进行交互。

特性

• 实现了模型上下文协议（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 参数以选择特定字段
• 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 监听地址用于HTTP上的JSON-RPC（默认 ":8080"）
  -sse
        启用SSE传输
  -stdio
        启用stdio传输（默认 true）

通常，您的MCP主机将运行该程序并启动MCP服务器，您不需要手动执行这些操作。但是，如果您想手动运行MCP服务器，例如因为您想通过HTTP（使用SSE）提供服务：

给定您的PATH环境变量配置为包括由$GOBIN命名的路径（如果未设置$GOBIN，则为$GOPATH/bin或$HOME/go/bin），您可以运行：

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

这将输出启动日志和SSE传输URL：

CBS API MCP服务器已启动，使用的传输方式：[sse]
SSE传输端点：http://localhost:8080

---

© 2025 David Stotijn — 本项目根据Apache License 2.0许可。