使用说明

项目简介

本项目 'mcp-cbs-cijfers-open-data' 是一个基于 Model Context Protocol (MCP) 的服务器实现，专门用于访问荷兰中央统计局 (CBS) 的开放数据 API。它为 AI 工具 (如大型语言模型) 提供了一系列工具，使其能够以结构化和标准化的方式查询和获取 CBS 的统计数据。通过此 MCP 服务器，AI 助手可以轻松地探索 CBS 的数据集、维度和具体观测数据，从而支持数据驱动的分析和应用。

主要功能点

访问 CBS 开放数据: 提供多种工具，方便快捷地访问 CBS 开放数据 API。
数据集和目录浏览: 能够列出所有可用的 CBS 数据目录和数据集，帮助用户发现所需数据。
元数据查询: 允许查询数据集的元数据和维度信息，了解数据的结构和内容。
数据检索与过滤: 支持根据条件过滤和检索统计数据，获取特定维度的观测值。
OData 查询支持: 利用 OData 标准，提供丰富的查询参数，如选择字段、过滤、排序、分页和搜索等高级查询功能。

安装步骤

安装 Go 环境: 确保您的计算机上已安装 Go 1.24 或更高版本。您可以从 Go 官网下载并安装。
安装 MCP 服务器程序: 您可以使用 'go install' 命令直接安装此 MCP 服务器程序。打开终端并执行以下命令：
```
go install github.com/dstotijn/mcp-cbs-cijfers-open-data@latest
```
安装成功后，可执行文件 'mcp-cbs-cijfers-open-data' 将位于您的 '$GOBIN' 目录下 (通常是 '$GOPATH/bin' 或 '$HOME/go/bin')。请确保此目录已添加到您的 'PATH' 环境变量中。

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是针对常见 MCP 客户端（如 Claude Desktop, Cursor）的 JSON 配置示例。您需要将此配置添加到您的 MCP 客户端设置中。

{
  "mcpServers": {
    "cbs-cijfers-open-data": { // 服务器名称，可以自定义
      "command": "mcp-cbs-cijfers-open-data", // 启动服务器的命令，假设 mcp-cbs-cijfers-open-data 可执行文件已在 PATH 环境变量中
      "args": [] // 启动参数，默认为空，使用 stdio 传输
    }
  }
}

更多服务器配置选项:

HTTP 传输 (SSE): 如果您希望使用 HTTP SSE 传输协议，可以修改 'args' 参数，并启用 '-sse' 标志。例如：

{
  "mcpServers": {
    "cbs-cijfers-open-data-sse": { // 服务器名称，可以自定义
      "command": "mcp-cbs-cijfers-open-data",
      "args": ["--stdio=false", "--sse"] // 禁用 stdio 并启用 sse 传输
    }
  }
}

同时，您可以使用 '-http' 参数指定 HTTP 监听地址，默认为 ':8080'。例如，监听地址为 'localhost:9090'：

{
  "mcpServers": {
    "cbs-cijfers-open-data-sse": {
      "command": "mcp-cbs-cijfers-open-data",
      "args": ["--stdio=false", "--sse", "--http=:9090"] // 指定 HTTP 监听端口为 9090
    }
  }
}

Stdio 传输: 默认情况下，服务器启用 stdio 传输。如果您只希望使用 stdio 传输，无需额外配置 'args' 参数。

基本使用方法

启动 MCP 服务器: MCP 客户端通常会自动启动配置的 MCP 服务器。如果需要手动启动，您可以在终端中执行 'mcp-cbs-cijfers-open-data' 命令。
在 AI 助手中使用工具: 在支持 MCP 协议的 AI 助手 (如 Claude, Cursor) 中，您可以调用以下工具来访问 CBS 数据：
- 'get_catalogs': 获取所有 CBS 数据目录。
- 'query_datasets': 查询 CBS 数据集，支持过滤、排序和分页等高级选项。
- 'get_dimensions': 获取指定数据集的所有维度信息。
- 'get_dimension_values': 获取指定维度所有可用的值。
- 'get_observations': 获取指定数据集的观测数据，可以添加过滤器。
- 'query_observations': 高级查询观测数据，支持 OData 查询参数。
- 'get_metadata': 获取 CBS API 的元数据文档。
使用示例 (假设在 Claude 中):

您可以提示 Claude 助手使用这些工具来查询 CBS 数据，例如：

'请使用 get_catalogs 工具列出所有可用的 CBS 数据目录。'

'请使用 query_datasets 工具查询标题包含 "价格指数" 的数据集，并使用 filter 参数排除状态为 "Gediscontinueerd" 的数据集。'

'请使用 get_observations 工具获取数据集 "7001bev" (人口数量) 的观测数据，并过滤年份为 2023 年的数据。'

AI 助手会根据您的指令调用相应的 MCP 工具，并将结果返回给您。请参考工具的具体参数说明来构建更复杂的查询。

关键词