nhtsa-vehicle-safety-mcp-server

Wait, need ensure exact link. Let me copy original. Actually let's re-read.

Original link: https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22nhtsa-vehicle-safety-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads/nhtsa-vehicle-safety-mcp-server%22%5D%7D Need far not modify. I accidentally wrote ... Let's copy exact.

Keep original exactly. Good.

Public Hosted Server: https://nhtsa.caseyjhand.com/mcp

Инструменты

Семь инструментов для запросов к данным о безопасности транспортных средств NHTSA:

nhtsa_get_vehicle_safety

Комплексный профиль безопасности — инструмент по умолчанию для вопросов о безопасности автомобиля, надёжности или решении о покупке.

• Объединяет рейтинги краш-тестов NCAP, историю отзывных кампаний и сводку жалоб в одном ответе.

• Рейтинги фронтального удара, бокового удара и опрокидывания для каждого варианта автомобиля.

• Текст последствий отзывной кампании, а также предупреждения «не садитесь за руль», «паркуйтесь на улице» и «обновление по воздуху (OTA)».

• Разбивка жалоб по компонентам с количеством ДТП, возгораний, травм и смертельных случаев.

• Возвращает sectionStatus и предупреждения, чтобы сбои вышестоящей системы не были приняты за чистую запись.

nhtsa_search_recalls

Поиск отзывных кампаний по автомобилю или номеру кампании.

• Поиск по марке/модели/году или по конкретному номеру кампании NHTSA.

• Поиск по кампании возвращает все марки/модели, охватываемые кампанией, а также расследование ODI, предшествовавшее ей.

• Необязательная фильтрация по диапазону дат (ISO 8601).

• Включает предупреждения «не садитесь за руль», «паркуйтесь на улице» и предупреждения об обновлении OTA.

nhtsa_decode_vin

Декодирование идентификационных номеров транспортного средства для получения данных о производстве и безопасности.

• Один VIN или пакетное декодирование до 50 VIN.

• Частичные VIN принимаются — используйте * для неизвестных позиций.

• Сохраняет разреженные поля VPIC, не заполняя отсутствующие данные пустыми заглушками.

nhtsa_search_investigations

Поиск расследования дефектов NHTSA.

• Типы расследований: предварительные оценки (PE), инженерные анализировки (EA), петиции о дефектах (DP), запросы отзыва (RQ), контрольные запросы (AQ), а также дополнительные коды ODI (SQ, EQ, RP и др.).

• Полнотекстовый поиск по идентификаторам дел, темам и сводкам расследований, плюс структурированные фильтры по марке, модели и компоненту.

• nhtsaId возвращает одно расследование по его точному ID — обратный ход по ссылке на отзыв, замыкающая цикл «кампания → расследование».

• Данные берутся из пакетного файла ODI NHTSA (FLAT_INV.zip) — первый запрос скачивает и разбирает его (~10 c), последующие используют кэшированный индекс (TTL 24 часа, совпадает с ежедневным обновлением файла).

• Возвращает до 25 расследований на страницу; в ответе повторно возвращаются offset/limit и смещение для следующей страницы.

nhtsa_search_complaints

Поиск жалоб потребителей на безопасность, поданных в NHTSA.

• Разбивка по компонентам с числом ДТП, возгораний, травм и смертных случаев.

• Необязательный фильтр по компоненту (например, "ENGINE", "AIR BAGS").

• Возвращает до 50 самых последних жалоб, отсортированных по дате подачи.

• Дата события, которая не согласуется с собственной датой подачи жалобы или годом модели, указывается как unreliableIncidentDate, а не передаётся как действительная дата события.

nhtsa_get_safety_ratings

Рейтинги краш-тестов NCAP и данные о функциях ADAS.

• Рейтинги фронтального столкновения, бокового удара (барьер + стойка) и опрокидывания.

• Функции ADAS: ESC, предупреждение о лобовом столкновении, предупреждения о выезде с полосы.

• Принимает либо марку/модель/год, либо переданный vehicleId из предыдущих результатов NCAP.

• Количество жалоб, отзывных кампаний и расследований в деле.

nhtsa_lookup_vehicles

Справочные запросы к базе данных VPIC NHTSA.

*Четыре операции: makes, models, vehicle_types, manufacturer.

• makes поддерживает постраничную навигацию с limit и offset по полному каталогу VPIC.

• Используйте для разрешения неоднозначных названий автомобилей или проверки правильности написания.

• Модели можно фильтровать по году; производители поддерживают частичное совпадение.

• manufacturer перелистывает VPIC с пределом в 500 записей и сообщает, когда широкое частичное совпадение достигает этого предела.

Related MCP server: vehicle-safety

Возможности

Построено на @cyan heads/mcp-ts-core:

• Декларативные определения инструментов — один инструмент на файл, фреймворк берёт на себя регистрацию и проверку.

• Единая обработка ошибок для всех инструментов.

• Подключаемая аутентификация (none, jwt, oauth).

• Сменные хранилища: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1.

• Структурированный журнал логирования с необязательной трассировкой OpenTelemetry.

• Запускается локально (stdio/HTTP) из одной базы кода.

Особенности NHTSA:

• Типобезопасный клиент для четырёх JSON API NHTSA с логикой повторов и нормализацией разреженных полей, а также потоковый парсер для пакетного файла расследований OD.

• Кэширование индекса расследований (TTL 24 часа) для быстрых повторных запросов.

• API-ключ не нужен — все API NHTSA открыты.

Быстрый старт

Публичный инвант

Публичный экземпляр доступен по адресу https://nhtsa.caseyjhand.com/mcp — установка не требуется. Подключите любой MCP-клиент через Streamable HTTP:

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

Собственный хостинг / Локально

Добавьте следующее в файл настроек вашего 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"
      }
    }
  }
}

Или через npx (без 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"
      }
    }
  }
}

Или с 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"]
    }
  }
}

Для Streamable HTTP укажите транспорт и запустите сервер:

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

Предварительные требования

• Bun v1.3.2 или выше (или Node.js >= 24.0.0)

Установка

1. Клонируйте репозиторий:

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

2. Перейдите в каталог проекта:

cd nhtsa-vehicle-safety-mcp-server

3. Установите зависимости:

bun install

Конфигурация

API-ключи не требуются — все API NHTSA открыты.

Источники данных

Все данные берутся из открытых API и пакетных файлов NHTSA:

• Recalls API — api.nhtsa.gov/recalls

• Complaints API — api.nhtsa.gov/complaints

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

• Investigations bulk file — static.nhtsa.gov/odi/ffdd/inv/FLAT_INV.zip

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

Запуск сервера

Локальная разработка

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

Продакшн

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

Структура проекта

Руководство по разработке

Рекомендации по разработке и архитектурные правила см. в CLAUDE.md. Кратко:

• Обработчики выбрасывают исключения, фреймворк перехватывает их — без try/catch в логике инструментов.

• Для журнала используйте ctx.log.

• Один инструмент на файл, все имена инструментов начинаются с nhtsa_.

Участие

Issues и pull request приветствуются. Перед отправкой запустите проверки:

bun run devcheck
bun run test

Лицензия

Apache-2.0 — подробности в LICENSE.