Carvector

carvector-mcp

AI エージェントに実際の車両データを提供します。 Claude、Cursor、ChatGPT、または MCP 対応クライアントから、CarVector API を直接利用できる MCP サーバーです。車両の仕様、代表画像、連邦政府によるリコール、オーナーからの苦情、サービス速報、不具合調査、OBD-II の診断トラブルコードを照会できます。

モデルは車のデータを幻覚します。馬力の数値をでっち上げ、先週届け出があったリコールを見落とし、トラブルコードの意味を推測します。carvector-mcp を使えば、エージェントは自信ありげな推測ではなく、出典を示せる構造化された回答を返せます。

npx -y carvector-mcp --key cv_your_key

· MIT · 無料プランあり、カード不要 → carvector.io

---

クイックスタート

1. 無料の API キーを取得します。 carvector.io で、クレジットカード不要で月 500 件までリクエストできます。

2. MCP クライアントに追加します。 ほとんどのクライアントでは、mcpServers ブロックを使用します。

{
  "mcpServers": {
    "carvector": {
      "command": "npx",
      "args": ["-y", "carvector-mcp"],
      "env": { "CARVECTOR_API_KEY": "cv_your_key" }
    }
  }
}

これで完了です。クライアントを再起動して、車両について質問してみましょう。

リモートサーバーを使いたい場合は？ クライアントが HTTP MCP に対応していれば、インストールを省略して、ホストされているエンドポイントに直接接続できます。

{ "mcpServers": { "carvector": {
    "url": "https://api.carvector.io/v1/mcp",
    "headers": { "Authorization": "Bearer cv_your_key" } } } }

---

ツール

ツール	返される情報
search_vehicles	年式／メーカー／モデルで一致する車両。ID と仕様を含みます
get_vehicle	1 台の車両の詳細な仕様。エンジン、駆動系、ボディ、画像、リコール件数
get_recalls	車両の連邦政府によるリコール。対象部品、概要、影響、対処方法
get_complaints	車両に関するオーナーの苦情の傾向。部品別の集計と最新の苦情 (Pro プラン)
get_tsbs	車両に関するメーカーのサービス速報一覧。ディーラーがすでに把握している修理方法 (Business プラン)
get_investigations	車両に関する連邦政府の不具合調査。リコールの先行指標です (Business プラン)
lookup_dtc	OBD-II コードの名称、カテゴリ、重大度、安全性／排出ガス関連のフラグ

エージェントはこれらを自然につなげて使います。まず search_vehicles で ID を特定し、次に get_vehicle、get_recalls、get_complaints、get_tsbs、または get_investigations を呼び出します。

---

例

あなた：「P0300 コードは深刻ですか？」

→ carvector.lookup_dtc({ code: "P0300" })
{
  "code": "P0300",
  "title": "Random/Multiple Cylinder Misfire Detected",
  "category": "Powertrain",
  "severity": "High",
  "safety_risk": true,
  "emissions_related": true
}

エージェントの回答：「はい。P0300 は重大度が高く、安全に関わる失火コードです。そのまま運転を続けないでください。」推測ではなく、出典に基づく回答です。

---

これを使って作れるもの 3 つ

• サービスアドバイザー向けコパイロット。 顧客の正確なグレード、未解決のリコール、メーカーが文書化した修理方法（TSB）、症状の背後にある苦情の傾向、デコード済みのエンジン警告コードを、タブを切り替えることなく 1 回のやり取りで取得します。
• 一般消費者向けの車両チャットボット。 「自分のトラックのエンジンは何か」「リコール対象か」といった質問に、幻覚ではなく実際のデータで回答します。
• コーディング／自動車関連エージェント。 解析が必要なスクレイピングテキストの塊ではなく、ツールとして利用できる構造化された車両情報を必要とします。

---

キーを使わず、リクエストごとに支払う（x402）

CarVector の HTTP API は x402 による支払いにも対応しているため、ウォレットを持つエージェントは、アカウント登録もサインアップも API キーも不要で API を呼び出せます。リクエストごとに支払い、データを受け取れます。

• 1 回の呼び出しにつき $0.01 USDC、Base メインネット上 （USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• 支払いなしで有料エンドポイントにリクエストすると、支払いと再試行に必要な情報がすべて含まれた HTTP 402 が返されます。

curl -i "https://carvector.io/v1/vehicles?year=2020&make=Ford&model=F-150"
# HTTP/1.1 402 Payment Required
# { "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "base", ... } ] }

支払い可能なエンドポイント：/v1/vehicles、/v1/vehicles/:id、/v1/vehicles/:id/recalls、 /v1/vehicles/:id/complaints、/v1/vehicles/:id/tsbs、 /v1/vehicles/:id/investigations、/v1/dtc/:code。

この MCP クライアントは支払いを行いません。API キーを使用します。 carvector-mcp では CARVECTOR_API_KEY が必要で、キーがない場合は終了します。x402 は HTTP API を直接呼び出すためのものです。 エージェントからキーなしでアクセスしたい場合は、このパッケージを介さず、上記のエンドポイントを呼び出してください。

データについて

carvector-mcp はオープンソースの軽量クライアントです。データは一切同梱していません。すべての呼び出しは、キーで認証されて CarVector API に転送されます。取得できるデータは次のとおりです。

• 車両 — 幅広いカタログ（1925～2029 年）をトリムとエンジンのバリエーションごとに分類し、代表的なイラスト（写真ではありません）を掲載しています。
• リコール — 連邦政府のリコールキャンペーンを、年式／メーカー／モデルに紐付けています。
• 苦情 — オーナーから寄せられた苦情をコンポーネントごとに集計し（衝突／火災／負傷件数を含む）、最近の届け出とともに車両に紐付けています。(Pro プラン)
• サービス速報（TSB） — メーカーの技術サービス速報のインデックスです。文書ではなくメタデータを提供します。(Business プラン)
• 調査 — 連邦政府による欠陥調査です。リコールに先行することの多い先行指標です。(Business プラン)
• DTC リファレンス — OBD-II コードをカテゴリ、深刻度、安全性／排出ガスのフラグで分類しています。リファレンスのみです。修理費用の分析はロードマップに含まれており、現時点ではレスポンスに含まれません。

呼び出しはプランのレート制限にカウントされ、REST リクエストと同じようにダッシュボードに表示されます。

---

オープンソースとキー

このクライアントは読みやすい JavaScript で約 150 行です。ぜひコードをお読みください。クライアントは次のとおりです。

• 1 つのホストのみと通信します。api.carvector.io（index.js を検索すると、URL はこれだけです）。
• キーはそのホストに対する Bearer ヘッダーとしてのみ送信し、それ以外には送信しません。
• テレメトリ、アナリティクス、ホームへの通信は一切なく、ディスクへの書き込みも行いません。
• 依存パッケージは公式の @modelcontextprotocol/sdk の 1 つだけです。

キーはお使いのマシンに保存されます。CARVECTOR_API_KEY 環境変数で設定してください（推奨）。--key も使用できますが、他の CLI 引数と同様、プロセス一覧から参照できます。

ライセンス

MIT です。クライアントはオープンソースで、データは CarVector が提供しています。