mcp-cbs-cijfers-open-data

mcp-cbs-cijfers-open-data

本项目为 CBS Open Data API 提供 Model Context Protocol (MCP) 服务。它允许 AI 工具通过 MCP 工具与 CBS Open Data 交互。

功能

• 实现 Model Context Protocol (MCP) 服务
• 提供与 CBS Open Data 交互的工具：
  • 列出可用的数据集和目录
  • 查询数据集元数据和维度
  • 使用筛选选项获取统计数据
  • 浏览维度值

工具

此 MCP 服务提供以下工具，供 AI 助手与 CBS Open Data API 交互：

get_catalogs

获取所有可用的 CBS 数据目录。

参数：

• 无

query_datasets

从 CBS Open Data 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 listen address for JSON-RPC over HTTP (default ":8080")
  -sse
        Enable SSE transport
  -stdio
        Enable stdio transport (default 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 server started, using transports: [sse]
SSE transport endpoint: http://localhost:8080

---

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