nhtsa-vehicle-safety-mcp-server

Servidor público alojado: https://nhtsa.caseyjhand.com/mcp

Herramientas

Siete herramientas para consultar los datos de seguridad vehicular de la NHTSA:

nhtsa_get_vehicle_safety

Perfil de seguridad compuesto: la herramienta predeterminada cuando se pregunta por la seguridad de un vehículo, su fiabilidad o una decisión de compra.

• Combina las calificaciones de las pruebas de choque NCAP, el historial de retiradas y un resumen de quejas en una sola respuesta

• Calificaciones de choque frontal, choque lateral y vuelco para cada variante del vehículo

• Descripción de las consecuencias de la retirada, además de los avisos de no conducir el vehículo, de aparcarlo al aire libre y de actualización OTA (over-the-air)

• Desglose de quejas por componente con recuentos de choques, incendios, lesiones y muertes

• Informa sectionStatus y advertencias para que las caídas de los sistemas de origen no se confundan con un historial limpio

nhtsa_search_recalls

Busca campañas de retirada por vehículo por número de campaña.

• Búsqueda por marca / modelo / año o por un número de campaña específico de NHTSA

• Las búsquedas por campaña devuelven todas las marcas y modelos que cubre, más la investigación de ODI que le precedió

• Silgado opcional por fecha (ISO 8601)

• Incluye avisos de no conducir, advertencias de aparcar fuera y disponibilidad de actualización OTA

nhtsa_decode_vin

Decodifica los números de identificación del vehículo (VINs) para obtener datos de fabricación y seguridad.

• Un único VIN o decodificación en lote de hasta 50 VINs

• Se permiten VINs incompletos: usa * para las posiciones desconocidas

• Realiza un uso eficiente de los campos vacíos de VPIC en lugar de rellenar los datos faltantes con marcadores vacíos

nhtsa_search_investigations

Busca investigaciones de defectos de la NHTSA.

• Tipos de investigación: evaluaciones preliminares (PE), análisis de ingeniería (EA), peticiones de defecto (DP), consultas de retirada (RQ), consultas de auditoría (AQ) y otros códigos ODI (SQ, EQ, RP o similares)

• Búsqueda de texto libre entre identificadores, asuntos y resúmenes de investigación, además de filtros estructurados por marca, modelo y componente

• nhtsaId obtiene una investigación completa por su ID exacto: la inversa al el recordatorio de la retirada, y cierran el ciclo campaña-investigación

• Los datos provienen del archivo masivo de ODI de NHTSA (FLAT_INV.zip): la primera consulta lo descarga y lo procesa (~10 s), y las posteriores usan el índice en caché (TTL de 24 h, sincronizado con la actualización diaria del archivo)

• Devuelve hasta 25 investigaciones por página; la respuesta incluye offset/limit y el offset de la siguiente página

nhtsa_search_complaints

Busca quejas de seguridad de los consumidores presentadas ante la NHTSA.

• Desglose por componente con recuentos de choques, incendios, lesiones y muertes

• Filtro opcional de componente (p. ej., "ENGINE", "AIR BAGS")

• Devuelve hasta las 50 quejas más recientes ordenadas por fecha de construcción

• Una fecha de incidente descartada por la propia fecha de queja o antigüedad del modelo se devuelve como unreliableIncidentDate, en lugar de mostrarse fecha de incidente real

nhtsa_get_safety_ratings

Calificaciones de las pruebas de choque NCAP y datos de funcionalidades ADAS.

• Calificaciones de choque frontal, lateral (barrera + poste) y vuelco

• Funciones ADAS: ESC, aviso de colisión frontal y aviso de salida de carril

• Acepta bien marca/modelo/año o un vehicleId posterior de los resultados CNCAP

• Recuento de quejas, retiradas e investigaciones en el historial

nhtsa_lookup_vehicles

Consultas de referencia contra la base de datos de VPIC.

• Cuatro operaciones: makes, models, vehicle_types, manufacturer

• makes admite paginación con limit y offset para el catálogo completo de VPIC

• Útil para resolver nombres de vehículos ambiguos oámboles del / años

• Los modelos se pueden filtrar por año; los fabricantes permiten una coincidencia parcial

• manufacturer pagina VPIC hasta un máximo de 500 registros y notifica cuando una coincidencia parcial muy amplia toca su límite

Related MCP server: vehicle-safety

Características

Es compatible con @cyanheads/mcp-ts-core:

• Definiciones declarativas de herramientas; un formato por herramienta y un framework que gestiona su registro y validación

• Manejo unificado de errores

• Mecanismo de autenticación intercambiable (none, jwt, oauth)

• Backends de almacenamiento intercambiables: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1

• Registro estructurado con soporte opcional de seguimiento mediante OpenTelemetry

• Disponible localmente (stdin/HTTP) con el mismo código base

Particularidades de NHTSA:

• Cliente con seguridad de tipos que envuelve cuatro API JSON de NHTSA, con reinicio automático y normalización de campos escasos, además de un motor para el archivo masivo de ODI

• Caché de índice de investigaciones (TTL de 24 h) para realizar consultas rápidas

• No se requieren claves de API, ya que las APIs de NHTSA son públicas

Primeros pasos

Instancia pública alojada

Una instancia pública disponible en https://nhtsa.caseyjhand.com/ mc — sin necesidad de instalar nada. conecta cualquier cliente MCP a ella mediante HTTP Streamable:

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

Servidor propio o local

Añade el siguiente fragmento al fichero de configuración de tu cliente MCP:

{
  "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"
      }
    }
  }
}

Desde npx (sin necesidad de Bun):

{
  "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"
      }
    }
  }
}

Desde 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"]
    }
  }
}

Para HTTP Streamable, define el transporte y levanta el servidor:

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

Requisitos previos

• Bun v1.3.2 o superior (o Node.js >= 24.0.0)

Instalación

1. Clona el repositorio:

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

2. Abre el directorio:

cd nhtsa-vehicle-safety-mcp-server

3. Instala las dependencias:

bun install

Configuración

No se requiere claves de API: todas las apis de NHTSA son públicas.

Fuentes de datos

Los datos proceden de las APIs públicas y ficheros masivos de la NHTSA:

• API de retiros — api.nhtsa.gov/recalls

• API de quejas — api.nhtsa.gov/complaints

• API de calificaciones de seguridad — api.nhtsa.gov/Recalls

• Fichero masivo de investigaciones — static.nhtsa.gov/odi/ffdd/inv/FLAT_INV.zip

• API de VPICT — vpic.nhtsa.dot.gov/api/vehicles

Ejecutar el servidor

Desarrollo local

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

Producción

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

Estructura del proyecto

Guía de desarrollo

Consulta CLAUDE.md para conocer las normas de desarrollo y reglas de arquitectura. Resumen:

• Los manipuladores pueden detener la ejecución, pero framework se encarga de capturar — nunca se captura try/catch in tool

• Usa ctx.log para iniciar sesión

• Se puede una herramienta por fichero y prefijo nhtsa_ en todas.

Contribuciones

Los issues y pull requests son bienvenidos. Ejecuta las comprobaciones antes de enviar:

bun run devcheck
bun run test

Licencia

Apache-2.0 — consulta LICENSE para más detalles.