CBS Open Data MCP Server

CBS Open Data MCP Server

Een Model Context Protocol (MCP) server voor de CBS Open Data OData API.

Hiermee kunnen AI-assistenten (GitHub Copilot, Claude Desktop, etc.) direct CBS-statistieken opvragen, filteren en verkennen.

Beschikbare tools

| Tool | Omschrijving | |---|---| | query_datasets | Zoek datasets op titel of omschrijving met OData-filtering | | get_dataset_info | Haal metadata op voor één specifieke dataset | | get_dimensions | Haal dimensies en hun labelwaarden op voor een dataset | | get_dimension_values | Haal alle waarden op voor een specifieke dimensie | | get_measure_codes | Haal measure-definities op (de beschikbare meetkolommen) | | get_observations | Haal alle observaties op met automatische paginering en label-resolutie | | query_observations | Geavanceerde OData-query op observaties | | get_catalogs | Haal alle beschikbare CBS-catalogi op | | get_metadata | Haal het EDM-metadataschema op als XML |

Vereisten

• Python 3.10 of hoger
• uv (aanbevolen) of pip

Installatie

Met uv (aanbevolen)

git clone https://github.com/TdH25/cbs-open-data-mcp.git
cd cbs-open-data-mcp
uv sync

Met pip

git clone https://github.com/TdH25/cbs-open-data-mcp.git
cd cbs-open-data-mcp
pip install httpx "mcp>=0.9.1"

MCP-server instellen

VS Code (GitHub Copilot)

Voeg het volgende toe aan .vscode/mcp.json in je workspace (of gebruik het meegeleverde bestand):

{
  "servers": {
    "cbs-open-data": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--no-project",
        "--isolated",
        "--link-mode=copy",
        "--with", "mcp",
        "--with", "httpx",
        "python",
        "-m", "src.cbs_open_data_mcp_server"
      ]
    }
  }
}

Claude Desktop

Voeg het volgende toe aan claude_desktop_config.json:

{
  "mcpServers": {
    "cbs-open-data": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "/pad/naar/cbs-open-data-mcp",
        "python",
        "-m", "src.cbs_open_data_mcp_server"
      ]
    }
  }
}

Of installeer het pakket eerst (pip install . of uv sync) en gebruik dan het meegeleverde commando rechtstreeks:

{
  "mcpServers": {
    "cbs-open-data": {
      "command": "cbs-open-data-mcp"
    }
  }
}

Gebruik in de chat

Na installatie kun je hem gelijk gebruiken: stel in Copilot Chat of Claude een vraag over CBS-statistieken. De AI kiest zelf de juiste tools en werkwijze - mede dankzij meegeleverde copilot-instructies.

Voorbeeldprompts:

• "Welke datasets heeft CBS over aardgasverbruik?"
• "Haal de inwoners per provincie op uit 03759ned (meest recente jaar, totaal) en toon als tabel."
• "Toon de CO₂-uitstoot per sector over de afgelopen 5 jaar in een grafiek."
• "Haal dataset 80030ned op in een nieuwe Notebook en plot de totale elektriciteitsproductie per jaar per energiedrager in een stacked area chart met plotly."

!Example screenshot

Bekende beperkingen

• SSL-verificatie uitgeschakeld — de CBS API heeft een certificaatprobleem met de standaard CA-bundle. verify=False is standaard ingesteld.
• Trage API — de CBS OData API kan traag reageren; timeout is 60 seconden met 3 retry-pogingen.
• resolve_labels — label-resolutie maakt N+2 extra API-calls (N = aantal dimensies). Bij grote datasets kan dit merkbaar zijn.

Tests

uv run python -m unittest tests.test_cbs_open_data_client -v

Verwant project

mcp-cbs-cijfers-open-data van David Stotijn — een MCP-server voor dezelfde CBS Open Data API, geschreven in Go. Dit project is onafhankelijk ontwikkeld in Python en voegt onder andere automatische paginering, label-resolutie en measure-definitie-ondersteuning toe.

Licentie

MIT — zie LICENSE.