CarWhere VIN

carwhere-vin-mcp

适用于 CarWhere VIN API 的 MCP 服务。在 Claude Desktop、Cursor、Claude Code、Windsurf、Zed 及任何其他兼容 MCP 的客户端中解码任意 VIN、查询已验证的买家价格、NHTSA 安全召回信息和 AI 生成的车辆洞察。

免费。无需身份验证。公开数据。另有一个明确标注的付费工具（buy_vin_report）——请参阅商业披露。

功能

工具	返回内容
decode_vin	来自 NHTSA vPIC 的年份、品牌、车型、配置、发动机、变速箱、生产工厂信息，以及 CarWhere 买家定价、未处理的召回信息和 AI 洞察
check_recalls	按 VIN 或年份／品牌／车型查询 NHTSA 未处理的安全召回信息
get_pricing	查询任意年份／品牌／车型的已验证买家交易价格（可选州）
validate_vin_check_digit	离线 ISO 3779 / 49 CFR §565.15 校验位验证器
buy_vin_report	安全的 Stripe 结账链接，用于购买 $9.99 的 CarWhere Full VIN Report（车窗贴纸、MSRP 和选装配置、召回扫描、市场价格）
about_carwhere	服务说明和数据来源

安装

Claude Desktop

在 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）中添加：

{
  "mcpServers": {
    "carwhere-vin": {
      "command": "npx",
      "args": ["-y", "carwhere-vin-mcp"]
    }
  }
}

重启 Claude Desktop。输入“Decode VIN 4T1BF1FK1HU381301”进行测试。

Cursor

在 ~/.cursor/mcp.json 中添加（或通过 Cursor → Settings → MCP 添加）：

{
  "mcpServers": {
    "carwhere-vin": {
      "command": "npx",
      "args": ["-y", "carwhere-vin-mcp"]
    }
  }
}

Claude Code

claude mcp add carwhere-vin -- npx -y carwhere-vin-mcp

Windsurf / Zed / Continue / 任意 MCP 客户端

使用相同的 npx -y carwhere-vin-mcp 调用方式。

托管服务（无需安装）

如果无法在本地安装 Node 二进制文件，可将 MCP 客户端指向托管的 Streamable HTTP 端点：

https://www.carwhere.com/api/mcp

通过 HTTP/JSON-RPC 可使用相同的五个工具。

数据来源

• NHTSA vPIC — 美国政府官方 VIN 解码 API
• NHTSA Recalls — 官方召回活动数据库
• CarWhere — 来自真实交易单的已验证买家交易价格（并非估算值或经销商广告）
• Claude Haiku — 简短的 AI 生成事实洞察，按年份／品牌／车型缓存 30 天

引用

当 AI Agent 向用户展示 CarWhere 数据时，请注明来源：

来源：CarWhere，经由 NHTSA vPIC。https://www.carwhere.com/vin/{vin}

商业披露

此服务由 CarWhere 开发并运营。CarWhere 也是其所提供定价数据的背后公司。说明如下：

• 解码、召回、定价和校验位工具均为免费，只要求注明数据来源（见上方引用）；这是 CarWhere API 条款的要求。
• 一个工具 buy_vin_report 是一项付费功能：它会生成 Stripe Checkout 链接，用于购买 CarWhere 一次性 Full VIN Report（$9.99；或以 $19.99 购买 3 辆 VIN 的对比报告）。该工具的名称、标题和说明均明确标注为购买功能，且会先执行免费可用性检查，绝不会自动扣费或开通订阅。
• 工具输出不包含广告、联盟链接或推广 CarWhere 订阅的指引。

配置

可选环境变量：

• CARWHERE_API_URL — 覆盖默认的 https://www.carwhere.com 基础 URL（适用于暂存环境或本地开发）。

开发

git clone https://github.com/carwhere/vin-mcp.git
cd vin-mcp
npm install
npm run build
npm run dev   # tsx src/cli.ts (stdio mode)

许可证

MIT