nhtsa-vehicle-safety-mcp-server

公開ホステッドサーバー: https://nhtsa.caseyjhand.com/mcp

ツール

NHTSAの車両安全データを照会するための7つのツール:

nhtsa_get_vehicle_safety

総合セーフティプロファイル — 車両の安全性、信頼性、購入判断について求められた際の既定ツールです。

• NCAP衝突テスト評価、リコール履歴、苦情サマリーを1回のレスポンスに統合

• 車両バリアントごとの前面衝突、側面衝突、横転の評価

• リコール結果に関するテキストに加え、do-not-drive（運転禁止）、park-outside（屋外駐車）、および無線アップデート（OTA）に関する注意喚起

• コンポーネント内訳で、事故、火災、負傷、死亡の件数を表示

• sectionStatus と警告を返し、上流側の障害をクリーンレコードと誤認しないようにする

nhtsa_search_recalls

車両またはキャンペーン番号でリコールキャンペーンを検索します。

• メーカー/モデル/年式、または特定NHTSAキャンペーン番号で照会

• キャンペーン照会では、対象のメーカー/モデルすべてに加え、先行するODI調査も返されます。

• 必要な日付範囲フィルタ（ISO 8601）

• do-not-drive（運転禁止）注意、park-outside（屋外駐車）警告、OTAアップデートの利用可否を含む

nhtsa_decode_vin

製造および安全に関する詳細を取得するために、車両識別番号（VIN）をデコードします。

• 単一VINまたは最大50VINの一括デコード

• 部分VIN対応 — 不明な位置には * を使用します

• 欠損データに空のプレースホルダを入れず、疎なVPICフィールドをそのまま保持します

nhtsa_search_investigations

NHTSAの欠陥調査を検索します。

• 調査タイプ： Preliminary Evaluations (PE)、Engineering Analyses (EA)、Defect Petitions (DP)、Recall Queries (RQ)、Audit Queries (AQ)、その他のODIコード（SQ、EQ、RPなど）

• 調査ID、件名、概要のフリーテキスト検索に加え、構造化されたメーカー、モデル、コンポーネントのフィルタ

• nhtsaId は正確なIDで1件の調査を取得します — リコールへのリンクの逆方向、キャンペーンから調査への往復を埋めます

• NHTSAのODI一括ファイル（FLAT_INV.zip）をソースに使用 — 初回クエリではダウンロードと解析（約10秒）が行われ、以降はキャッシュされたインデックス（24時間TTL、ファイルの毎日更新に対応）を使用

• 1ページあたり最大25件の調査を返します。レスポンスには offset/limit と次ページへのオフセットが含まれます

nhtsa_search_complaints

NHTSAに提出された消費者の安全に関する苦情を検索します。

• 事故、火災、負傷、死亡の件数にコンポーネント内訳

• オプションのコンポーネントフィルタ（例： “ENGINE”、 “AIR BAGS”）

• 提出日順に最大50件の最新苦情を返します

• 苦情の内容が提出日またはモデル年と矛盾する事故日は、発生日として提供するのではなく unreliableIncidentDate として表示されます

nhtsa_get_safety_ratings

NCAP衝突テスト評価とADAS機能データ。

• 正面衝突、側面衝突（バリア＋ポール）、横転評価

• ADAS機能：ESC、前方衝突警告、車線逸脱警告

• メーカー/モデル/年または以前のNCAP結果のフォローアップ用 vehicleId を受け入れる

• 記録されている苦情、リコール、調査の数値

nhtsa_lookup_vehicles

NHTSAのVPICデータベースに対する参照照会。

• 4つの操作： makes、 models、 vehicle_types、 manufacturer

• makes はVPIC全カタログを対象に limit と offset のページネーションをサポート

• 曖昧な車両名の解決や、スペルの確認に使用できます

• モデルは年でフィルタでき、メーカーは部分一致に対応

• manufacturer はVPICを最大500件までページングし、広い部分名称がその上限に達した場合にそれを開示します

Related MCP server: vehicle-safety

特徴

@cyanheads/mcp-ts-core を基盤に構築：

• 宣言的なツール定義 — ツールごとに1ファイル。フレームワークが登録と検証を処理

• 全ツール共通の統一エラーハンドリング

• プラガブル認証（none、 jwt、 oauth）

• 交換可能なストレージバックエンド: in-memory、 filesystem、 Supabase、 Cloudflare KV/R2/D1

• 構造化ログと選択式のOpenTelemetryトレーシング

• 同じコードベースからローカル（stdio/HTTP）で実行

NHTSA固有の機能：

• 再試行ロジックと技法 (sparse-field) の正規化を備えたNHTSA JSON API23をラップした型安全クライアント、およびODI調査の一括ファイル用ストリーミング解析器

• 調査インデックスのキャッシュ（24時間TTL）による繰り返しクエリの高速化

• APIキー不要 — NHTSAのAPIはすべて公開されています

はじめに

公開ホステッドインスタンス

公開インスタンスは https://nhtsa.case축전지.com/mcp で利用できます — インストール不要。Streamable HTTPで任意のMCPクライアントを接続できます：

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

または npm（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キーは不要です — NHTSAのAPIはすべて公開されています。

データソース

すべてのデータはNHTSAの公開APIと一括ファイルから取得されます：

• リコールAPI — api.nhtsa.gov/recalls

• 苦情API — api.nhtsa.gov/complaints

• 安全評価API — api.nhtsa.gov/SafetyRatings.

• 調査一括ファイル — static.nhtsa.gov/odi/ffd/inv/FLAT_INV.zip

• VPIC API — vpic.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 を使用

• 1ツールずつトードファイル。全ツール名に nhtsa_ プレフィックスを使用

コントリビューション

Issue とプルリクエストは歓迎します。提出前にチェックを実行してください：

bun run devcheck
bun run test

ライセンス

Apache-2.0 — 詳細は LICENSE を参照してください。