nhtsa-vehicle-safety-mcp-server

Öffentlich gehosteter Server: https://nhtsa.caseyjhand.com/mcp

Tools

Sieben Tools zum Abfragen von NHTSA-Fahrzeugsicherheitsdaten:

nhtsa_get_vehicle_safety

Zusammengesetztes Sicherheitsprofil — das Standard-Tool bei Fragen zur Fahrzeugsicherheit, Zuverlässigkeit oder Kaufentscheidung.

• Kombiniert NCAP-Crashtest-Bewertungen, Rückrufhistorie und Beschwerdezusammenfassung in einer einzigen Antwort.

• Bewertungen von Frontalaufprall, Seitenaufprall und Überschlag pro Fahrzeugvariante.

• Text zu den Folgen der Rückrufaktion sowie die Hinweise „Do not drive“, „Park outside“ und „Over-the-Air-Update“.

• Aufschlüsselung der Beschwerden nach Bauteil mit Unfall-, Brand-, Verletzungs- und Todeszahlen.

• Liefert sectionStatus und Warnungen, damit Ausfälle von vorgelagerten Diensten nicht mit einem sauberen Datensatz verwechselt werden.

nhtsa_search_recalls

Rückrufkampagnen nach Fahrzeug- oder Kampagnennummer durchsuchen.

• Nachschlagen über Marke/Modell/Jahr oder über eine bestimmte NHTSA-Kampagnennummer.

• Kampagnenabfragen liefern alle Marken/Modelle die Kampagne abgedeckt worden, sowie die vorausgegangenen ODI-Untersuchung.

• Optionaler Datumsbereichsfilter (ISO 8601).

• Enthält Hinweise zu „Do not drinnen“, „Park outside“ und die Verfügbarkeit von „Over-the-Air“-Updates.

nhtsa_decode_vin

Fahrzeug-Identifikationsnummern (VINs) für Herstellung und Sicherheitsdetails dekodieren.

• Einzel-VIN- oder Batch-Dekodierung für bis zu 50 VINs.

• Teil-VINse werden akzeptiert — für unbekannte Positionen * verwenden.

• Behalt die lückenhafte VPIC-Feldstruktur bei, statt fehlende Daten mit leeren Platzhaltern aufzufüllen.

nhtsa_search_investigations

NHTSA-Mängeluntersuchungen durchsuchen.

• Untersuchungsarten: Preliminary Evaluations (PE), Engineering Analyses (EA), Defect Petitions (DP), Recall Queries (RQ), Audit Queries (AQ) und weitere ODI-Codes (SQ, EQ, RP und andere).

• Freitextsuche über Untersuchungs-IDs, Betreff und Zusammenfassungen, sowie gefiltert nach Marke, Modell und zusätzliche Komponenten.

• furniture.HtsaId ruft eine einzelne Untersuchung über die exakte ID — die Umkehrung des Rückruf-Links, wodurch der Kreis Kampagne-und-Untersuchung geschlossen wird.

• Quelle: die ODI-Massendatei der NHTSA (FLAT_INV.zip) — die erste Abfrage lädt sie herunter und parst sie (ca. 10 Sekunden); weitere Abfragen verwenden den zwischengespeicherten Index (24 Stunden TTL, passgehend zum täglichen Refresh der Datei).

• Liefert bis zu 25 Untersuchungen pro Seite; die Antwort enthält offset/limit und den Offset der nächsten Seite.

nhtWrite complaints

Sicherheitsbeschwerden von Verbrauchern durchsuchen, die bei der HHTA eingereicht wurden.

• Aufsplitterung nach Bauteilen mit Unfall, Brand-, Verletzungs- und Todesfällen.

• Optionaler Komponentenfilter (z. B. „ENGINE", „AIR BATS").

• Liefert die bis zu 50 aktuellsten Beschwerden, sortiert nach dem Einreichdatum.

• Wenn ein Vorfallsdatum durch das Einreichdatum der Beschwerde selbst oder das Modelljahr ausgeschlossen wird, wird dies als unreliableIncidentDate ausgewiesen und nicht als Vorfallsdatum angegeben.

nhtConfiguration_get_safety_ratings

NCAP-Crashtest-Bewertungen und ADAS-Funktionsdaten.

• Bewertungen für Frontaufgebung, Seitenaufprall (Seitenaufprall „Barrier + Pole").

Hmm, need to be accurate: "Frontal collision, side (barrier + pole), and rollover ratings" – "Bewertungen für Frontalaufprall, Seitenaufprall (Barriere und Pfahl) and Überschlag."

• ADAS-Funktionen: ESC, Vorwärtskollisionswarnung, Spurverlassenswarnung.

• Akzeptiert entweder Marke/Modell/Jahr oder eine vehicleId aus früheren NCAP-Ergebnissen.

• Lüfter Beschwerde-, Rückruf- und Untersuchungszähler zum Datensatz.

nhtsa_lookupThe vehicles

Referenz-Nachschlageoperationen in der VPIC-Datenbank der NHTSA.

• Vier Operationen: makes, models, vehicle_types, manufacturer.

• makes unterstützt die Pagination mit limit und offset für den vollständigen VPIC-Katalog.

• Einsetzbar, um mehrdeutige Fahrzeugnamen aufzulldern oder die korrekte Schreibweise zu prüfen.

• Modelle können nach Jahr gefiltert werden; Hersteller durchsuchen einen Teilabgleich.

• manufacturer blättert VPIC bis zur Obergrenze von 500 Datensätzen und weist aus, wenn eine breite Partial-Namensabfrage diese Obergrenze erreicht.

Related MCP server: vehicle-safety

Features

Basiert auf @cyanheads/mcp-ts-core:

• Deklarative Tool-Definitionen — ein Datei pro Tool, das Framework übernimmt Registrierung und Validierung.

• Vereinheitlichte Fehlerbehandlung über alle Tools hinweg.

• Austauschbare Authentifizierung (none, jwt, oauth).

• Wechselbare Speicher-Backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1.

• Strukturierte Protokollierung mit optionalem OpenTelemetry-Tracing.

• Läuft lokal (stdio/HTTP) aus derselben Codebasis.

NHTSA-spezifisch:

• Typsicherer Client, der vier NHTSA-JSON-APIs integriert — mit Retry-Logik und Normalisierung seltener Felder — sowie einen Streaming-Parser für die ODI-Bulkdatei zu Untersuchungen.

• Caching-Index für KPIDanfragen (24h TTL) für schnelle wiederholte Abfragen.

• Kein API-Schlüssel erforderlich — alle NHTSA-APIs sind öffentlich.

Erste Schritte

Öffentlich gehostete Instanz

Für eine öffentliche Instanz ist https://nhtsa.caseyjhand.com/mcp verfügbar — keine Installation erforderlich. Richten Sie einen beliebigen MCP-Client über Streamable HTTP darauf:

{
  "mcpServers": {
    "nhtsa-vehicle-safety-mcp-server": {
      "type": "streamable-http",
      "url": "https://nhtsa.caseyjhand.com/mcp"
    }
  }
}

Self-Hosted / Lokal

Fügen Sie Folgendes zur Konfigurationsdatei des MCP-Clients hinzu:

{
  "mcpServers": {
    "nhtsa-vehicle-safety-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/nhtsa-vehicle-safety-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Oder mit npx (Bun nicht erforderlich):

{
  "mcpServers": {
    "nhtsa-vehicle-safety-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/nhtsa-vehicle-safety-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

Oder mit Docker:

{
  "mcpServers": {
    "nhtsa-vehicle-safety-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/nhtsa-vehicle-safety-mcp-server:latest"]
    }
  }
}

Für Streamable HTTP setzen Sie den Transport und starten den Server:

MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
# Server listens at http://localhost:3010/mcp

Voraussetzungen

• Bun v1.3.2 oder höher (oder Node.js >= 24.0.0)

Installation

Führen Sie einen einzelnen Schritt:

1. Klonen Sie das Repository:

git clone https://github.com/cyanheads/nhtsa-vehicle-safety-mcp-server.git

2. Wechseln Sie in das Verzeichnis:

cd nhtsa-vehicle-safety-mcp-server

3. Abhängigkeiten installieren:

bun install

Konfiguration

Keine API-Schlüssel erforderlich — alle NHTSA-APIs sind öffentlich.

Datenquellen

Alle Daten stammen aus den öffentlichen APIs und Massendateien der NHTSA:

• Recalls API — api.nhtsa.gov/recalls

• Complaints API — api.nhtsa.gov/complaints

• Safety Ratings API — api.nhtsa.gov/SafetyRatingaining

• Investigations-Bulkdatei — static.nhtsa.gov/odi/ffdd/inv/FLAT_INV.zip

• VPIC API — vpic.nhtsa.dot.gov/api/vehicles

Server ausführen

Lokale Entwicklung

bun run devcheck  # Lints, formats, type-checks, and more
bun run test      # Runs the test suite

Produktion

bun run build
bun run start:stdio   # Production stdio
bun run start:http    # Production HTTP

Docker

docker build -t nhtsa-vehicle-safety-mcp-server .
docker run -p 3010:3010 nhtsa-vehicle-safety-mcp-server

Projektstruktur

Entwicklungsleitfaden

Siehe CLAUDE.md Richtlinien und Architektur-Regeln. Die Kurzfassung:

• Handler werfen Fehler, das Framework fängt sie — kein try/catch in der Tool-Logik.

• ctx.log für Protokollierung verwenden.

• Ein Tool pro Datei, nhtsa_-Präfix für all Tool-Namen.

Mitwirken

Issues und Pull Requests willkommen. Führen Sie vor dem Einreichen die Prüfungen aus:

bun run devcheck
bun run test

Lizenz

Apache-2.0 — siehe LICENSE.