开放数据协议服务器

mcp-cbs-数字-开放数据

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

特性

• 实现a 模型上下文协议 （MCP） 服务器
• 提供与CBS开放数据交互的工具：
  • 列出可用的数据集和目录
  • 查询数据集元数据和维度
  • 使用过滤选项检索统计数据
  • 探索维度值

工具

此MCP服务器为人工智能助手提供以下工具，以便与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服务元数据文档。

参数：

• 无

需求

• 转到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 （或 $GOPATH/bin $HOME/go/bin 如果 $GOBIN 未设置），则可以 运行：

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许可证2.0