Carvector

carvector-mcp

为你的 AI Agent 提供真实的车辆数据。 这是一个 MCP 服务，让 Claude、Cursor、ChatGPT 或任何支持 MCP 的客户端都能直接查询 CarVector API，获取车辆规格、代表性图片、联邦召回、车主投诉、服务公告、缺陷调查和 OBD-II 故障码。

模型会幻觉出汽车数据。它们会编造马力数据，漏掉上周发布的召回信息，还会猜测故障码的含义。carvector-mcp 为你的 Agent 提供有来源、可引用的结构化答案，而不是自信满满的猜测。

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	单辆车的完整规格 — 发动机、传动系统、车身、图片、召回数量
get_recalls	车辆的联邦召回活动 — 部件、摘要、后果、补救措施
get_complaints	车辆的车主投诉信号 — 按部件汇总，并列出最新投诉 (Pro 套餐)
get_tsbs	车辆的制造商服务公告索引 — 经销商已知的修复方案 (Business 套餐)
get_investigations	车辆的联邦缺陷调查 — 召回的先行指标 (Business 套餐)
lookup_dtc	OBD-II 故障码的名称、类别、严重程度以及安全／排放标记

Agent 会自然地串联这些工具：先用 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
}

你的 Agent 会回答：“是的 — P0300 是严重程度较高、与安全相关的失火故障码。别继续开了。” 答案有来源，而非猜测。

---

用它构建三类应用

• 服务顾问副驾：一次对话即可获取客户的准确配置、未处理的召回、制造商记录的修复方案（TSB）、症状背后的投诉模式，以及解码后的发动机故障码，无需在标签页之间切换。
• 面向消费者的汽车聊天机器人：以真实数据而非幻觉回答“我的卡车装的是什么发动机”和“它是否有召回”。
• 编码／汽车 Agent：需要将结构化车辆知识作为工具，而不是需要解析的大段抓取文本。

---

按次付费，而非使用密钥（x402）

CarVector HTTP API 也接受 x402 付款，因此拥有钱包的 Agent 可以在无需账号、无需注册、无需 API 密钥的情况下调用它——按请求付费并获取数据。

• 在 Base 主网上，每次调用 0.01 美元 USDC （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。如果你想让 Agent 无密钥访问，请调用上述端点，而不要通过此软件包。

关于数据

carvector-mcp 是一款开源的轻量客户端。它不捆绑任何数据——每次调用都会使用你的密钥进行身份验证，并转发到 CarVector API。你可以获取：

• 车辆 — 覆盖范围广泛的目录（1925–2029），按配置和发动机变体分类，并提供代表性插图（非照片）。
• 召回 — 按年份／品牌／车型映射的联邦召回行动。
• 投诉 — 按部件汇总的车主提交投诉（含碰撞／火灾／伤害数量），以及最新提交的投诉，并映射到对应车辆。（Pro 计划。）
• 服务公告（TSB） — 制造商的技术服务公告索引——提供元数据，不含文档。（Business 计划。）
• 调查 — 联邦缺陷调查；这是召回前常见的领先指标。（Business 计划。）
• DTC 参考 — 按类别、严重程度以及安全／排放标志分类的 OBD-II 代码。仅供参考——维修成本分析已列入路线图，目前不会在响应中提供。

调用次数会计入你计划的速率限制，并显示在你的控制面板中，与 REST 请求完全相同。

---

开源与你的密钥

此客户端只有约 150 行易读的 JavaScript——请阅读代码。它：

• 只连接一个主机——api.carvector.io（搜索 index.js，这是唯一的 URL），
• 只通过 Bearer 标头将你的密钥发送到该主机，不会发送到其他地方，
• 完全不包含遥测、分析或回传机制，也不会向磁盘写入任何内容，
• 只依赖一个软件包：官方 @modelcontextprotocol/sdk。

你的密钥会保留在你的机器上。通过 CARVECTOR_API_KEY 环境变量设置（推荐）；也可以使用 --key，但和其他命令行参数一样，它会显示在进程列表中。

许可证

MIT。客户端为开源软件；数据由 CarVector 提供。