RDW MCP Server

Ein Model Context Protocol (MCP)-Server zum Abfragen niederländischer RDW-Fahrzeugregistrierungsdaten (Rijksdienst voor het Wegverkeer). Bei Angabe eines Kennzeichens (kenteken) liefert er Fahrzeugspezifikationen, Kraftstoff-/Emissionsdaten, APK-/Prüfhistorie, Registrierungs-/Eigentümerhistorie, Achs- und Aufbauspezifikationen, Mängelcodes und den Status offener Rückrufe – alles aus der offiziellen RDW-Open-Data-API. Führen Sie ihn lokal über stdio/npx aus oder stellen Sie ihn als Remote-MCP-Server auf Cloudflare Workers bereit und verbinden Sie ihn direkt mit claude.ai.

Schnellstart

Wählen Sie Ihre bevorzugte Methode:

• Globale Installation (empfohlen): npm install -g rdw-mcp-server → rdw-mcp

• NPX (ohne Installation): npx rdw-mcp-server

• Lokale Entwicklung: Repository klonen → npm install → npm run build → node build/index.js

• Remote (Cloudflare Workers): Ganz ohne lokalen Prozess – einmal bereitstellen und von claude.ai als benutzerdefinierten Connector verbinden. Siehe Als Remote-MCP-Server bereitstellen.

Installation testen:

rdw-mcp        # if globally installed
# OR
npx rdw-mcp-server  # if using npx

(Drücken Sie Ctrl+C zum Beenden)

Zu Claude Desktop hinzufügen (siehe Konfigurationsabschnitt unten)

Stellen Sie Fragen wie:

• „Kennzeichen 12-ABC-3 nachschlagen"

• „Zeig mir die APK-Historie und eventuelle technische Mängel für kenteken 1-ABC-23"

Related MCP server: NS Travel MCP Server

Funktionen

• Vollständige Kennzeichenabfrage: Verfügbare Fahrzeuginformationen aus RDW-Datenbanken anhand des niederländischen Kennzeichens (kenteken) abrufen

• Umfassende Fahrzeugdaten: Basisspezifikationen, technische Details, Gewichte, Abmessungen und Registrierungsinformationen

• Integrierte Kraftstoff- und Emissionsdaten: Detaillierte Kraftstoffart, Emissionen, Umweltspezifikationen und Geräuschpegel

• APK-Prüfhistorie: Verlauf der periodischen Prüfberichte und daraus resultierende APK-Ablaufdaten

• Registrierungshistorie: Verlauf der Eigentümer-/Registrierungsänderungen

• Technische Spezifikationen: Achslasten, Aufbauarten und detaillierte technische Daten

• Mängelaufzeichnungen: Bei Prüfungen festgestellte Mängelcodes

• Status offener Rückrufe: Ob für das Fahrzeug derzeit ein Herstellerrückruf offen ist

• Echtzeitdaten: Zugriff auf aktuelle Informationen aus offiziellen RDW-Datenbanken

• Remote oder lokal: Lokal über stdio/npx ausführen oder als serverlosen Remote-MCP-Server auf Cloudflare Workers bereitstellen – siehe Als Remote-MCP-Server bereitstellen

Installation

Globale Installation (für CLI-Nutzung empfohlen)

npm install -g rdw-mcp-server

Nach der globalen Installation können Sie den Server direkt ausführen:

rdw-mcp

Verwendung von NPX (Ausführen ohne Installation)

npx rdw-mcp-server

Dies führt das Paket direkt aus, ohne es global zu installieren.

Aus dem Quellcode (lokale Entwicklung)

git clone https://github.com/yourusername/rdw-mcp-server.git
cd rdw-mcp-server
npm install
npm run build
node build/index.js

Verwendung

Als globaler Befehl

Nach der globalen Installation starten Sie den MCP-Server:

Stdio-Modus (Standard):

rdw-mcp

HTTP-Modus:

rdw-mcp --http          # Runs on port 3000
rdw-mcp --http --port=8080  # Custom port

Der Server unterstützt sowohl stdio- als auch HTTP-Transports:

• Stdio: Für direkte Befehlszeilen- und Claude-Desktop-Integration

• HTTP: Für Fernzugriff, Web-Integrationen und skalierbare Bereitstellungen

HTTP-Transport-Funktionen

Im HTTP-Modus (--http) bietet der Server:

• MCP-Endpunkt: POST /mcp – Hauptendpunkt des MCP-Protokolls

• Health-Check: GET /health – Serverstatus und Versionsinformationen

• CORS-Unterstützung: Ursprungsübergreifende Anfragen für Web-Integrationen aktiviert

• Zustandsloses Design: Keine Sitzungsverwaltung, ideal für Skalierung

• Fehlerbehandlung: Korrekte HTTP-Statuscodes und JSON-RPC-Fehlerantworten

Beispiel für HTTP-Nutzung:

# Start HTTP server
rdw-mcp --http --port=3000

# Health check
curl http://localhost:3000/health

# MCP requests (requires proper JSON-RPC format)
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

In der MCP-Client-Konfiguration (VS Code)

Die MCP-Unterstützung von VS Code (.vscode/mcp.json) verwendet einen servers-Schlüssel mit einem expliziten type:

Verwendung der globalen Installation (empfohlen):

{
  "servers": {
    "rdw": {
      "type": "stdio",
      "command": "rdw-mcp"
    }
  }
}

Verwendung von npx (Alternative):

{
  "servers": {
    "rdw": {
      "type": "stdio",
      "command": "npx",
      "args": ["rdw-mcp-server"]
    }
  }
}

Für Claude Desktop verwenden Sie stattdessen den mcpServers-Schlüssel, der unten unter Konfiguration für Claude Desktop gezeigt wird.

Lokaler Entwicklungsmodus

Für lokale Entwicklung aus dem Quellcode:

git clone https://github.com/yourusername/rdw-mcp-server.git
cd rdw-mcp-server
npm install
npm run build
node build/index.js

Entwicklungsmodus

Für Entwicklung mit automatischem Neubau:

npm run dev

Als Remote-MCP-Server bereitstellen (Cloudflare Workers)

Dieses Repository enthält außerdem einen Cloudflare-Worker-Einstiegspunkt (src/worker.ts), der dasselbe rdw-license-plate-lookup-Tool als Remote-MCP-Server bereitstellt – kein lokaler Prozess, kein Tunnel, kein Container. Da dieses Tool nur öffentliche RDW-Open-Data weiterleitet (keine Geheimnisse, keine Benutzerdaten), kann es ohne OAuth zu claude.ai hinzugefügt werden.

Dies ist rein additiv: Die bestehende npx rdw-mcp-server-/Claude-Desktop-stdio-Einrichtung oben bleibt unberührt.

Option A: Bereitstellung über das Cloudflare-Dashboard (keine lokale CLI erforderlich)

1. Forken Sie dieses Repository oder pushen Sie es in Ihr eigenes GitHub-Konto.

2. Im Cloudflare-Dashboard: Workers & Pages → Create → Import a Git repository.

3. Autorisieren Sie die Cloudflare-GitHub-App (einmaliger OAuth-Klick) und wählen Sie Ihr Repository aus.

4. Cloudflare erkennt wrangler.jsonc automatisch und füllt den Build-/Deploy-Befehl vor. Klicken Sie auf Save and Deploy.

5. Cloudflare führt npm install + wrangler deploy in der Cloud aus und liefert Ihnen eine Live-URL, z. B. https://rdw-mcp-worker.<your-subdomain>.workers.dev.

6. Jeder zukünftige Push an den verbundenen Branch wird automatisch neu gebaut und bereitgestellt.

Option B: Lokale Bereitstellung mit Wrangler

npm install
npm run cf:dev          # local Worker at http://localhost:8787

Lokal mit dem MCP Inspector verifizieren:

npx @modelcontextprotocol/inspector
# connect to http://localhost:8787/mcp (Streamable HTTP) or http://localhost:8787/sse (SSE)

Dann bereitstellen:

npx wrangler login   # first time only
npm run deploy

Zu claude.ai hinzufügen

1. claude.ai → Settings → Connectors → Add custom connector.

2. Fügen Sie Ihre bereitgestellte URL mit dem /mcp-Pfad ein, z. B. https://rdw-mcp-worker.<your-subdomain>.workers.dev/mcp.

3. Lassen Sie die OAuth-Client-ID-/Secret-Felder leer – dieser Server ist ohne Authentifizierung.

4. Klicken Sie auf Add und aktivieren Sie ihn dann über + → Connectors in einer Konversation.

5. Versuchen Sie: „Kennzeichen 12-ABC-3 nachschlagen".

Hinweise

• Der Worker ist nach der Bereitstellung öffentlich – jeder mit der URL kann die RDW-Abfrage darüber aufrufen. Das ist in Ordnung, da er nur bereits öffentliche RDW-Daten ohne Authentifizierung auf RDW-Seite weiterleitet. Bedenken Sie dies jedoch, bevor Sie in Zukunft Schreibaktionen oder private Daten hinzufügen (fügen Sie dann einen OAuth-Anbieter hinzu).

• Der Worker verwendet McpAgent (aus dem Paket agents), das auf Durable Objects basiert und sowohl /mcp (Streamable HTTP) als auch /sse (Legacy-SSE) für eine breite Client-Kompatibilität bereitstellt.

Verfügbares Tool

rdw-license-plate-lookup

Fahrzeuginformationen aus RDW-Datenbanken anhand des niederländischen Kennzeichens abrufen.

Parameter:

• kenteken (string): Niederländisches Kennzeichen, das nachgeschlagen werden soll

Rückgabe:

• Fahrzeuginformationen aus RDW-Datenbanken, einschließlich:

  • Basisdaten: Marke, Modell, Farbe, Typ, Variante, Version

  • Technische Spezifikationen: Motor, Leistung, Abmessungen, Zylinder, Hubraum

  • Gewicht & Kapazität: Leergewicht, Eigengewicht, Anhängelast, Achslasten

  • Registrierungsdaten: Erstzulassung, Registrierungs-/Eigentümerwechselhistorie, Typgenehmigung

  • Prüfaufzeichnungen: APK-Ablaufdatum, Verlauf der periodischen Prüfberichte, festgestellte Mängelcodes

  • Kraftstoff & Emissionen: Kraftstoffart, Emissionswerte, CO2-Klasse, Geräuschpegel

  • Sicherheitsinformationen: Status offener Rückrufe (die offenen Daten der RDW legen keine fahrzeugbezogene Rückrufhistorie offen, sondern nur, ob derzeit ein Rückruf offen ist)

  • Aufbauspezifikationen: Carrosserie-Typ, europäische Klassifikationen

  • Finanzdaten: Katalogpreis, BPM-Steuerinformationen

  • Statusindikatoren: Exportstatus, Taxi-Kennzeichen, Versicherungsstatus

Beispiel: Kennzeichen „12-ABC-3" für vollständige RDW-Datenbankinformationen nachschlagen

Anforderungen

• Node.js: Version 18.0.0 oder höher

• npm: Version 8.0.0 oder höher (wird mit Node.js geliefert)

• Internetverbindung: Für den Zugriff auf die RDW-API erforderlich

Konfiguration für Claude Desktop

Um diesen MCP-Server mit Claude Desktop zu verwenden, fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

Verwendung der globalen Installation (empfohlen)

Wenn Sie global mit npm install -g rdw-mcp-server installiert haben:

{
  "mcpServers": {
    "rdw": {
      "command": "rdw-mcp"
    }
  }
}

Verwendung von NPX (Alternative)

Wenn Sie keine globale Installation bevorzugen:

{
  "mcpServers": {
    "rdw": {
      "command": "npx",
      "args": ["rdw-mcp-server"]
    }
  }
}

Nur Entwicklungsmodus

Für Entwicklung mit lokalem Quellcode:

Windows

{
  "mcpServers": {
    "rdw": {
      "command": "node",
      "args": ["C:\\ABSOLUTE\\PATH\\TO\\rdw-mcp\\build\\index.js"]
    }
  }
}

macOS/Linux

{
  "mcpServers": {
    "rdw": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/rdw-mcp/build/index.js"]
    }
  }
}

Datenquellen

Dieser Server verwendet offizielle RDW-Open-Data-APIs (niederländische Fahrzeugbehörde), live verifiziert gegen opendata.rdw.nl:

• Basis-API: https://opendata.rdw.nl/resource/

• Fahrzeugregistrierung: Datensatz m9d7-ebf2 – Basisfahrzeuginformationen und Spezifikationen

• Kraftstoff & Emissionen: Datensatz 8ys7-d773 – Kraftstoffarten, Emissionen und Umweltdaten

• APK-/Prüfberichte: Datensatz sgfe-77wx („Meldingen Keuringsinstantie") – Verlauf der periodischen Prüfberichte und daraus resultierende APK-Ablaufdaten

• Registrierungshistorie: Datensatz db8s-mw3u („Kenteken-tenaamstelling") – Verlauf der Registrierungs-/Eigentümerwechsel

• Achsenspezifikationen: Datensatz 3huj-srit – Technische Achslastspezifikationen

• Aufbauarten: Datensatz vezc-m2t6 – Carrosserie- und Aufbauklassifikationen

• Technische Mängel: Datensatz a34c-vvps („Geconstateerde Gebreken") – Bei Prüfungen festgestellte Mängelcodes

Hinweis: Die offenen Daten der RDW legen keinen fahrzeugbezogenen Rückrufdatensatz offen (nur einen allgemeinen Rückrufkampagnen-Katalog ohne Kennzeichenfeld) und auch keinen separaten fahrzeugbezogenen Farbverlaufsdatensatz – Farben sind bereits im Basisfahrzeugdatensatz enthalten. Der Status offener Rückrufe stammt stattdessen aus einem Flag im Basisfahrzeugdatensatz.

Alle Daten werden in Echtzeit aus offiziellen Regierungsquellen abgerufen und sind öffentlich verfügbar.

Datenschutz & Datennutzung

• Keine Datenspeicherung: Dieser Server speichert keine Fahrzeugdaten lokal

• Echtzeitabfragen: Alle Anfragen werden direkt an RDW-APIs weitergeleitet

• Nur öffentliche Daten: Es wird nur auf öffentlich verfügbare Registrierungsdaten zugegriffen

• Keine Authentifizierung: Es werden keine persönlichen oder sensiblen Daten benötigt oder verarbeitet

Ratenbegrenzung

Die RDW-API kann Ratenbegrenzungen auferlegen. Wenn Sie auf Ratenbegrenzung stoßen:

• Warten Sie einige Sekunden zwischen den Anfragen

• Vermeiden Sie Massenanfragen in schneller Folge

• Erwägen Sie, Verzögerungen in Ihre Anwendungslogik einzubauen

Beispielabfragen

Sobald Sie mit einem MCP-Client wie Claude Desktop verbunden sind, können Sie Fragen stellen wie:

Vollständige Fahrzeuginformationen:

• „Kennzeichen 12-ABC-3 nachschlagen"

• „Welche Informationen sind für kenteken XYZ-123 verfügbar?"

• „Erzähl mir etwas über das Fahrzeug mit dem Kennzeichen 1-ABC-23"

• „Zeig mir alle Daten für das Kennzeichen ABC-12-D"

• „Vollständige RDW-Informationen für kenteken DEF-456 abrufen"

Spezifische Informationsanfragen:

• „Welche Emissionsdaten hat kenteken ABC-12-D?"

• „Zeig mir die APK-Historie für das Kennzeichen XYZ-456"

• „Gibt es Rückrufe für das Fahrzeug 12-ABC-3?"

• „Wie ist die Registrierungshistorie von kenteken DEF-456?"

• „Zeig mir technische Mängel für das Kennzeichen GHI-789"

Technische & Sicherheitsdetails:

• „Wie hoch ist die Anhängelast des Fahrzeugs 12-ABC-3?"

• „Zeig mir die Achsenspezifikationen für kenteken XYZ-456"

• „Gibt es offene Rückrufe für das Kennzeichen ABC-12-D?"

• „Welche Mängel wurden bei den Prüfungen für kenteken DEF-456 festgestellt?"

• „Zeig mir die vollständige Prüfhistorie für das Kennzeichen GHI-789"

Technische Details

• Sprache: TypeScript

• Laufzeit: Node.js (stdio / HTTP) oder Cloudflare Workers (Remote-MCP)

• Protokoll: Model Context Protocol (MCP)

• Transport: Standard-I/O (stdio), Streamable HTTP oder SSE (Cloudflare-Workers-Bereitstellung)

• Validierung: Zod-Schemas für Eingabevalidierung

• API: RESTful-Aufrufe an RDW-Open-Data-Endpunkte

Fehlerbehandlung

Der Server enthält eine umfassende Fehlerbehandlung für:

• Ungültige Kennzeichen (falsches Format oder nicht vorhanden)

• Netzwerkverbindungsprobleme

• API-Ratenbegrenzung und Timeouts

• Fehlende oder fehlerhafte Daten von der RDW-API

• Ungültige Suchparameter

Fehlerbehebung

Häufige Probleme

Server startet nicht:

• Stellen Sie sicher, dass die Node.js-Version 18.0.0 oder höher ist: node --version

• Versuchen Sie eine Neuinstallation: npm uninstall -g rdw-mcp-server && npm install -g rdw-mcp-server

Keine Daten zurückgegeben:

• Überprüfen Sie Ihre Internetverbindung

• Überprüfen Sie das Format des Kennzeichens (niederländische Kennzeichen: XX-XXX-X, XXX-XX-X usw.)

• Bei einigen älteren Fahrzeugen sind möglicherweise nicht alle Daten in der RDW-Datenbank vorhanden

Claude Desktop-Verbindungsprobleme:

• Überprüfen Sie, ob Ihre Konfiguration zur Installationsmethode passt (global vs. npx)

• Bei globaler Installation stellen Sie sicher, dass der Befehl rdw-mcp im Terminal funktioniert

• Bei Verwendung von npx stellen Sie sicher, dass npx rdw-mcp-server im Terminal funktioniert

• Starten Sie Claude Desktop nach Konfigurationsänderungen neu

• Stellen Sie bei Entwicklungssetups sicher, dass der absolute Pfad und das Build-Verzeichnis korrekt sind

Hilfe erhalten

Wenn Sie auf Probleme stoßen:

1. Prüfen Sie die Konsolenausgabe auf Fehlermeldungen

2. Überprüfen Sie, ob Ihr Kennzeichenformat den niederländischen Standards entspricht

3. Testen Sie mit bekannten gültigen Kennzeichen

4. Stellen Sie sicher, dass Sie über eine aktive Internetverbindung verfügen

Lizenz

MIT

Mitwirken

Beiträge sind willkommen! Dieser MCP-Server kann um weitere RDW-Datensätze oder Funktionen erweitert werden.

Entwicklungseinrichtung

1. Repository klonen:

   git clone https://github.com/jodur/rdw-mcp-server.git
   cd rdw-mcp-server

2. Abhängigkeiten installieren:

   npm install

3. Erstellen und testen:

   npm run build
   npm start

Verfügbare RDW-Datensätze

Die RDW stellt viele weitere Datensätze bereit, die integriert werden könnten, über die bereits oben verwendeten hinaus:

• Taxi- und Busregistrierungen

• Kraftstoffspezifische technische Varianten

• Import-/Export-Fahrzeughistorie

Codestil

• Verwenden Sie TypeScript mit strenger Typisierung

• Befolgen Sie bestehende Codemuster

• Fügen Sie JSDoc-Kommentare für alle Funktionen hinzu

• Verwenden Sie Zod für die Eingabevalidierung

• Integrieren Sie eine ordnungsgemäße Fehlerbehandlung

Änderungsprotokoll

Version 2.3.0

• NEU: Remote-MCP-Server auf Cloudflare Workers: src/worker.ts hinzugefügt, bereitstellbar über das Cloudflare-Dashboard (Git-Integration, keine CLI erforderlich) oder wrangler deploy. Stellt /mcp (Streamable HTTP) und /sse bereit, ohne Authentifizierung – direkt von claude.ai als benutzerdefinierter Connector verbindbar.

• Gemeinsame Tool-Logik: Das RDW-Nachschlagetool wurde in src/rdw-lib.ts extrahiert und wird unverändert sowohl vom Node-Einstiegspunkt als auch vom Worker importiert – keine doppelte Logik, keine Verhaltensänderung bei der bestehenden stdio/HTTP-Verteilung.

• Datenlücke behoben: Das Tool behauptete zuvor, APK-Verlauf, Rückrufe, Eigentümerhistorie und Mängel zurückzugeben, hat sie aber nie tatsächlich abgerufen (Annahmen, dass der endpoint doesn't exist, die sich als falsch herausstellten). Live gegen opendata.rdw.nl verifiziert und die echten Datensätze für APK-/Inspektionsverlauf (sgfe-77wx), Registrierungs-/Eigentümerhistorie (db8s-mw3u) und festgestellte Mängel (a34c-vvps) angebunden.

• Behauptungen korrigiert: Tool-Beschreibung und README behaupten nicht mehr, Rückrufverlauf oder fahrzeugspezifische Farbverlaufsdaten bereitzustellen, die die offene RDW-API tatsächlich nicht offenlegt – der Rückrufstatus wird nun korrekt als offenes/geschlossenes Flag beschrieben, nicht als Verlauf.

Version 2.1.0

• NEUER TRANSPORT: Unterstützung für Streamable-HTTP-Transport hinzugefügt (zustandslos)

• SDK-Konformität: Auf moderne MCP-TypeScript-SDK-Muster aktualisiert

• HTTP-Funktionen: Express.js-Server mit /mcp-Endpunkt und /health-Prüfung

• Befehlszeile: --http- und --port=N-Argumente für den HTTP-Modus hinzugefügt

• CORS-Unterstützung: Cross-Origin-Anfragen für Web-Integrationen aktiviert

• Zustandsloses Design: Neue Serverinstanz pro Anfrage, perfekt für die Skalierung

• Moderne API: Von veraltetem server.tool() auf server.registerTool() aktualisiert

• Verbesserte Struktur: Bessere Codeorganisation mit getrennten Funktionen

• Doppelter Transport: Unterstützt sowohl stdio (Standard) als auch HTTP-Transporte

Version 2.0.0

• GROSSE ERWEITERUNG: Fragt jetzt ALLE verfügbaren RDW-Datenbanken in einer einzigen Abfrage ab

• APK-Inspektionsverlauf und -aufzeichnungen hinzugefügt

• Informationen zu Fahrzeugrückrufen und Sicherheitsmaßnahmen hinzugefügt

• Vollständige Registrierungs-/Eigentümerhistorie hinzugefügt

• Achslastangaben und technische Daten hinzugefügt

• Karosserietyp- und Carrosserie-Klassifizierungen hinzugefügt

• Technische Mängelaufzeichnungen und Inspektionsergebnisse hinzugefügt

• Zusätzliche Farbinformationen hinzugefügt

• Verbessertes paralleles Datenabrufen für höhere Leistung

• Umfassende Fahrzeugdaten aus 8+ RDW-Datensätzen

• Tool-Beschreibung und Dokumentation aktualisiert

Version 1.1.0

• BREAKING CHANGE: Auf ein einziges umfassendes Nachschlagetool vereinfacht

• Alle Kraftstoff- und Emissionsdaten in die Haupt-Kennzeichenabfrage integriert

• Separate Kraftstoff-/Emissions- und Fahrzeugsuchtools entfernt

• Verbesserte Anzeige der Kraftstoff-/Emissionsdaten mit Emissionscodes und Rußemissionen

• Verbesserte Datenvollständigkeit in einer einzigen Abfrage

Version 1.0.2

• Umfassende README-Verbesserungen für npm-Benutzer

• Verbesserte Installations- und Verwendungsanweisungen

• Abschnitte zur Fehlerbehebung und zum Datenschutz hinzugefügt

• Verbesserte Beispielabfragen und Entwicklungseinrichtung

• package.json-Verweise auf entfernte Testdateien korrigiert

Version 1.0.1

• Verbesserte Fahrzeugdatenausgabe

• Verbesserte Kennzeichennormalisierung

• Umfassende Fehlerbehandlung hinzugefügt

• Dokumentation verbessert

Version 1.0.0

• Erste Veröffentlichung

• Grundlegende Kennzeichenabfrage

• Kraftstoff- und Emissionsdaten

• Fahrzeugsuche nach Marke/Modell

Haftungsausschluss

Dieser Server verwendet öffentliche RDW-Daten und ist nicht mit der offiziellen RDW-Organisation verbunden. Überprüfen Sie kritische Fahrzeuginformationen stets über offizielle Kanäle.