Skip to main content
Glama
theorie-mcp

theorie-mcp

Official
by RibbaBV

theorie-mcp

Een MCP-server met de volledige theorie voor het autorijbewijs B in Nederland: elf hoofdstukken met 134 paragrafen, alle 175 verkeersborden uit bijlage 1 van het RVV 1990, 182 begrippen en de wetsartikelen waar elke regel op rust. Gratis, zonder account en zonder sleutel.

De inhoud zit in het pakket. De server werkt dus zonder netwerk en zonder database.

Gemaakt en onderhouden door Ribba, de vergelijker voor rijscholen en gratis theorie in Nederland.

Installeren

Er is geen account en geen sleutel nodig. Elke client hieronder start de server zelf met npx, dus je hoeft niets vooraf te installeren behalve Node 20 of nieuwer.

Claude Code

claude mcp add --scope user theorie -- npx -y @ribba/theorie-mcp

--scope user schrijft hem naar ~/.claude.json, waarmee hij in al je projecten werkt en ook beschikbaar is in het Code-tabblad van de desktop-app. Laat je --scope weg, dan geldt hij alleen in de map waar je op dat moment staat. Wil je hem juist met je team delen, gebruik dan --scope project: die schrijft naar .mcp.json in de repo, en dat bestand hoort in versiebeheer.

Codex

codex mcp add theorie -- npx -y @ribba/theorie-mcp

Of met de hand in ~/.codex/config.toml:

[mcp_servers.theorie]
command = "npx"
args = ["-y", "@ribba/theorie-mcp"]

De Codex-CLI, de IDE-extensie en de ChatGPT-desktopapp lezen alle drie datzelfde bestand, dus één keer instellen is genoeg. Zet je het in .codex/config.toml binnen een project, dan geldt het alleen daar.

Claude Desktop

De chat-app deelt zijn instellingen niet met Claude Code en heeft een eigen bestand:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "theorie": {
      "command": "npx",
      "args": ["-y", "@ribba/theorie-mcp"]
    }
  }
}

Herstart de app daarna. Heb je hem daar al staan en wil je hem ook in Claude Code, dan neemt claude mcp add-from-claude-desktop hem over.

Cursor, Windsurf en andere clients

Dezelfde JSON als hierboven, in het configuratiebestand van je client.

Related MCP server: Dutch-law-mcp

Werkt het?

Vraag je client:

Wat betekent verkeersbord B6?

Komt er een antwoord met de betekenis en het wetsartikel erbij, dan staat de server. Zo niet:

  • De server staat er niet bij. De meeste clients lezen hun instellingen alleen bij het opstarten. Sluit hem helemaal af en start opnieuw.

  • npx: command not found of een foutmelding over de Node-versie. Je hebt Node 20 of nieuwer nodig. Controleer met node --version; installeren kan via nodejs.org.

  • De eerste keer duurt even. npx haalt het pakket dan nog op, en daar zit de hele theorie in. Daarna start hij meteen, ook zonder internet.

  • Nog steeds niets? Start de server met de hand en kijk wat hij zegt: npx -y @ribba/theorie-mcp. Hij wacht dan op invoer, wat betekent dat hij werkt; foutmeldingen komen erbij te staan.

Kom je er niet uit, open een issue of mail team@ribba.nl.

Wat je kunt vragen

  • Wat betekent bord B6, en waar wordt het het vaakst mee verward?

  • Wie heeft er voorrang op een rotonde?

  • Leg de regels voor stilstaan en parkeren uit, met de wetsartikelen erbij.

  • Overhoor me over verkeerstekens en aanwijzingen, zonder de antwoorden te laten zien.

  • Wat staat er letterlijk in artikel 15 van het RVV?

  • Wat is het verschil tussen een voorrangsweg en een gelijkwaardig kruispunt?

Gereedschappen

Naam

Wat het teruggeeft

zoek

Zoekt door hoofdstukken, borden, begrippen en oefenvragen tegelijk. Begin hier als je niet weet waar iets staat.

hoofdstukken

De elf hoofdstukken met samenvatting, niveau en bijbehorende borden.

hoofdstuk

De volledige tekst van één hoofdstuk, per paragraaf met de wetsartikelen erbij.

verkeersborden

Alle borden uit bijlage 1, te filteren op groep.

verkeersbord

Eén bord: betekenis, wat je doet, veelgemaakte fouten, plaatsingsvoorschrift en artikelen.

begrippen

De begrippenlijst, doorzoekbaar, met de officiële CBR-woordenlijst apart te filteren.

begrip

Eén begrip in het volle: uitleg, regels, valkuilen en waar het mee verward wordt.

wetsartikel

De letterlijke tekst van een artikel, met verwijzing naar wetten.overheid.nl.

oefenvragen

Oefenvragen met antwoord en uitleg, of zonder antwoord om te overhoren.

De wet zit erbij

Bij 111 van de 134 paragrafen staat het wetsartikel waar de regel op rust, en de server geeft de letterlijke wettekst mee. Dat is het verschil tussen "je moet rechts houden" en artikel 3 van het RVV 1990, met een verwijzing naar wetten.overheid.nl waar het staat.

Dat is niet alleen netjes. Verkeersregels veranderen, en een theorieantwoord zonder bron is niet na te kijken. Zes regelingen zitten erin, met samen ruim tweeduizend artikelen: het RVV 1990, de Wegenverkeerswet 1994, de Regeling voertuigen, het BABW, het Reglement rijbewijzen en de Regeling eisen theorie-examen rijbewijscategorie B.

Wat dit niet is

Dit is lesstof, geen CBR-examen. De oefenvragen zijn door Ribba geschreven en zijn geen examenvragen van het CBR. Ze zijn er om te toetsen of de stof zit, niet om een examen na te bootsen.

De afbeeldingen van de verkeersborden zijn de officiële borden uit bijlage 1 van het RVV 1990, overgenomen van wetten.overheid.nl. Elk bord in de uitvoer heeft een afbeelding-veld dat naar die afbeelding wijst. Op wetten, besluiten en verordeningen van de openbare macht rust geen auteursrecht (Auteurswet artikel 11).

De inhoud

De theorie in data/ is een momentopname en gaat mee in het pakket. Verandert er iets aan de cursus, dan verschijnt dat in een nieuwe versie van deze server. package.json vertelt welke je hebt; de laatste staat op npm.

Wijkt iets af van wat er op ribba.nl staat, dan is die site de bron. Laat het weten via een issue of team@ribba.nl, dan zetten we het recht.

Testen

npm install
npm run build
npm test

De tests draaien tegen de meegeleverde inhoud, dus zonder netwerk. Naast de gereedschappen zelf controleren ze de samenhang: dat elk bord waar een hoofdstuk naar verwijst bestaat, en dat elke wetsverwijzing in de cursus een echte wettekst oplevert.

Zelf draaien

npm install
npm run build
node dist/index.js

De server praat JSON-RPC over stdin en stdout. Handmatig starten is vooral nuttig om de foutuitvoer te zien; normaal doet je MCP-client dit.

Deze theorie op het web

Alles wat deze server teruggeeft staat ook als gewone pagina op ribba.nl, met afbeeldingen, voorbeelden en oefenvragen erbij:

Wil je de theorie op je eigen site zetten? Dat mag, en het kan met een kant-en-klaar kader: zie gratis theorie aanbieden.

Elk bord, begrip en hoofdstuk in de uitvoer bevat een pagina-veld dat naar de bijbehorende pagina wijst.

Licentie

De code staat onder de MIT-licentie. De wetteksten en de bordafbeeldingen zijn overheidspublicaties zonder auteursrecht. De cursusteksten, de begrippenlijst en de oefenvragen zijn geschreven door Ribba en staan onder CC BY 4.0. Verwijs bij hergebruik naar https://ribba.nl.

Verwant

  • cbr-mcp voor de CBR-slagingspercentages per rijschool, examencentrum, stad en provincie.

  • rijschool-mcp voor de rijscholen zelf: adressen, prijzen, beoordelingen en dekkingsgebied.

Vragen of iets kapot? team@ribba.nl of open een issue.

Available Tools

9 tools
begripEén begripA

De volledige uitleg van één begrip: wat het is, welke regels erbij horen, welke fouten ermee gemaakt worden, waar het mee verward wordt en op welke wetsartikelen het rust.

Inputs: term (required).

begrippenBegrippenlijstC

De begrippen die je voor het theorie-examen moet kennen, met een korte omschrijving. Een deel komt uit de woordenlijst van het CBR zelf.

Inputs: zoekwoord, alleen_cbr.

hoofdstukEén hoofdstukA

De volledige tekst van één hoofdstuk: alle paragrafen met hun kernregel en uitleg, en per paragraaf de wetsartikelen waar de regel op rust, met de letterlijke wettekst.

Inputs: slug (required), met_wetteksten.

hoofdstukkenAlle hoofdstukkenA

De elf hoofdstukken van de theoriecursus, met per hoofdstuk de samenvatting, het aantal paragrafen, de bijbehorende verkeersborden en het niveau dat het CBR vraagt.

Inputs: no named parameters.

oefenvragenOefenvragenB

Oefenvragen met het juiste antwoord, de uitleg en de wetsartikelen erbij. Door Ribba geschreven en geen examenvragen van het CBR.

Inputs: limiet, onderwerp, met_antwoord.

verkeersbordEén verkeersbordB

Alles over één verkeersbord: wat het betekent, wat je moet doen, waar je het tegenkomt, de fouten die er het vaakst mee gemaakt worden, de borden waar het mee verward wordt, het plaatsingsvoorschrift en de wetsartikelen.

Inputs: code (required).

verkeersbordenVerkeersbordenA

Alle verkeersborden uit bijlage 1 van het RVV 1990, met code, naam en groep. Filter op groep om alleen de snelheidsborden of alleen de voorrangsborden te krijgen.

Inputs: groep, met_uitleg.

wetsartikelWetsartikel opzoekenA

De letterlijke tekst van een artikel uit het RVV 1990, de Wegenverkeerswet of een van de andere regelingen waar de theorie op rust, met een verwijzing naar wetten.overheid.nl. Zonder verwijzing krijg je de lijst met regelingen.

Inputs: verwijzing.

zoekZoeken in de theorieA

Zoek door de hele theorie tegelijk: hoofdstukken, paragrafen, verkeersborden, begrippen en oefenvragen. Geeft per treffer een fragment en de sleutel waarmee je het volledige stuk ophaalt. Begin hier als je niet weet in welk hoofdstuk iets staat.

Inputs: vraag (required), limiet.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: chapter lists versus chapter details, sign lists versus sign details, concept lists versus concept details, plus law articles, practice questions, and a search tool. No overlapping functionality.

    Naming Consistency5/5

    The naming pattern is consistent: singular nouns for single-item details, plural nouns for lists, and a straightforward verb 'zoek' for search. All names are lowercase, without separators, matching a uniform style.

    Tool Count5/5

    With 9 tools, the set is well-scoped for a traffic theory resource, covering navigation, details, and search without unnecessary redundancy or bloat.

    Completeness5/5

    The toolset fully covers the domain: chapters, traffic signs, concepts, law articles, practice questions, and cross-cutting search. It provides both overview and detail access, leaving no major gaps for the intended use case.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for ANWB traffic information, route planning, and location search in the Netherlands. Provides real-time traffic incidents, route calculation with turn-by-turn directions, and location search via natural language.
      6
      9 npm
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      Enables querying over 3,200 Dutch statutes (AVG, Wetboek van Strafrecht, Burgerlijk Wetboek, etc.) with verbatim, citation-grounded text from official sources, directly from MCP-compatible AI assistants.
      18
      49 npm
      15
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables querying CBR driving exam pass rates and exam statistics by driving school, exam centre, city, and province, including rankings and trends over time.
      8
      7 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides access to all driving schools in the Netherlands with addresses, contact details, prices, ratings, service areas, and CBR pass rates. Free, no account or API key needed.
      6
      12 npm
      MIT