Carsxe MCP Server

🚗 CarsXE MCP服务器

一个模块化、可扩展的模型上下文协议（MCP）服务器，用于查询和分析来自 CarsXE API，为LLM和聊天机器人提供美观、聊天友好的Markdown输出。

______________________________________________________________________

ℹ️ 什么是CarsXE MCP服务器？

CarsXE MCP服务器是 Node.js/TypeScript 该应用程序公开了一套用于从CarsXE API查询综合车辆数据的工具。它旨在与LLM（如Anthropic Claude、OpenAI GPT等）、聊天机器人和开发工具无缝集成，提供：

• 🧩 干净的模块化代码 对于每个CarsXE端点
• 📝 一致的、富含Markdown的输出 用于聊天/LLM环境
• 🛡️ 稳健的错误处理 以及用户友好的消息
• 🔌 易于扩展 用于新的端点和功能

______________________________________________________________________

💡 为什么要将CarsXE与MCP结合使用？

通过MCP将CarsXE连接到您的AI编辑器或聊天客户端，可以直接在您已经使用的工具中为您提供增压车辆数据体验：

______________________________________________________________________

✨ 特性

• 🤖 使用Anthropic-Claude根据API数据和用户查询生成全面、专业的答案
• 🚙 查询车辆规格、历史、图像、召回、市场价值等
• 🏷️ 解码车牌和VIN（包括图像的OCR）
• 🛠️ 解码OBD（车载诊断）代码
• 🎨 所有端点都返回优雅的分组表情Markdown
• 🧑‍💻 模块化代码：类型、API逻辑和格式化程序是分开的，以便于维护
• 🧪 易于运行、测试和扩展

______________________________________________________________________

⚙️ 先决条件

CarsXE API钥匙 (在这里买一个)

______________________________________________________________________

🖥️ 编辑器安装

所有编辑器都使用相同的远程MCP端点。替换 YOUR_API_KEY 在下面的每个配置中使用您实际的CarsXE API密钥。

______________________________________________________________________

克劳德桌面版

1.️⃣ 下载并安装Claude Desktop

• 去找官方 克劳德桌面下载页面
• 下载适用于您的操作系统（macOS、Windows或Linux）的安装程序
• 按照屏幕上的说明安装Claude Desktop

2.️⃣ 配置Claude Desktop以使用CarsXE MCP服务器

a.打开克劳德桌面设置

• 启动Claude Desktop应用程序
• 点击 克劳德 在菜单栏中
• 选择 设置
• 在“设置”窗口中，转到 开发者 选项卡（您可能需要滚动或展开高级选项）
• 点击 编辑配置 （或 打开配置文件)

b.编辑配置文件

• 这将打开 claude_desktop_config.json 默认文本编辑器中的文件。

• 找到 "mcpServers" 部分。如果不存在，请按如下所示添加。

• 为CarsXE添加或更新以下条目：

  "mcpServers": {
    "carsxe": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.carsxe.com/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  },

• 替换 YOUR_API_KEY 使用您的CarsXE API钥匙

• 提示： 您可以在下面添加多个MCP服务器 "mcpServers" 如果你使用多个。

• 保存 打开配置文件并关闭编辑器。

c.重新启动克劳德桌面

• 关闭并重新打开Claude Desktop应用程序以应用新配置。

> 更改可能需要短暂的延迟才能生效。

3.️⃣ 验证CarsXE MCP服务器是否可用

• 重新启动后，打开Claude Desktop。
• 转到工具或插件部分（通常在搜索栏或工具菜单下）。
• 你应该看看 CarsXE 列为可用的MCP服务器/工具。
• 尝试运行CarsXE工具（例如，获取车辆规格）以验证一切正常。

> 只有当您的API密钥与活动订阅相关联时，这才会起作用。

______________________________________________________________________

光标

为Cursor安装CarsXE MCP

安装对话框将打开，其中预先填充了：

替换 YOUR_API_KEY 与你的实际 CarsXE API钥匙，然后单击 安装.

______________________________________________________________________

Visual Studio代码（GitHub副本）

为VS代码安装CarsXE MCP

单击安装后，您需要手动添加API密钥：

1. 打开 命令面板 (Ctrl+Shift+P / Cmd+Shift+P)
2. 跑 MCP：列出服务器
3. 找到 CarsXE 在列表中单击它
4. 点击 显示配置
5. 替换 YOUR_API_KEY 与你的实际 CarsXE API钥匙:

   "CarsXE": {
     "type": "http",
     "url": "https://mcp.carsxe.com/mcp",
     "headers": {
       "X-API-Key": "YOUR_ACTUAL_KEY_HERE"
     }
   }

1. 保存文件——VS Code将自动连接。

注： 确保你有 GitHub Copilot 已安装扩展并启用代理模式(chat.agent.enabled 在VS代码设置中）。

______________________________________________________________________

帆板运动

1.️⃣ 打开MCP配置

• 首选 风帆设置 → 主控程序 （或按 Ctrl+, 并搜索MCP）
• 点击 “编辑配置” 打开 ~/.codeium/windsurf/mcp_config.json

2.️⃣ 添加CarsXE服务器

{
  "mcpServers": {
    "carsxe": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.carsxe.com/mcp",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

3.️⃣ 重新启动Windsurf

重新加载窗口或重新启动Windsurf。打开Cascade聊天面板——CarsXE工具将自动出现。

______________________________________________________________________

其他编辑器（手动/通用）

对于任何其他兼容MCP的客户端，请使用以下方式注册远程MCP服务器：

• 端点： https://mcp.carsxe.com/mcp
• 运输： HTTP（流式HTTP）
• 身份验证标头： X-API-Key: YOUR_API_KEY

有关确切的配置格式，请参阅编辑的MCP文档。

______________________________________________________________________

🛠️ 可用工具和示例提示

以下是所有可用的CarsXE工具及其参数和示例提示的列表。这些提示在任何连接MCP的客户端中都有效。

1. get-vehicle-specs 🚙

• 说明： 通过VIN获取全面的车辆规格

• 参数：

- vin （字符串，必填）：17个字符的车辆识别号

• 示例提示：

> VIN的完整规格是什么 WBAFR7C57CC811956?

> 这是V6还是V8？VIN： WBAFR7C57CC811956

> 什么是修剪水平 WBAFR7C57CC811956?

• 输出： Markdown格式的车辆规格（年份、品牌、型号、发动机、尺寸、颜色、设备等）

______________________________________________________________________

2. decode-vehicle-plate 🏷️

• 说明： 解码车辆牌照以获取VIN和基本信息

• 参数：

- plate （字符串，必填）：车牌号 - state （字符串，可选）：州缩写（例如CA） - country （字符串，必填，默认值：美国）：国家代码

• 示例提示：

> 什么车有车牌 7XER187 在加利福尼亚？

> 解码板 7XER187 状态 CA

> 看看盘子 ABC1234 得克萨斯州

• 输出： 解码车辆信息的Markdown摘要（VIN、品牌、型号、年份等）

______________________________________________________________________

3. international-vin-decoder 🌍

• 说明： 解码国际VIN以获取详细信息

• 参数：

- vin （字符串，必填）：17个字符的VIN

• 示例提示：

> 解码此欧洲VIN： WF0MXXGBWM8R43240

> 什么车 WAUZZZ8K9AA123456这是一个德国VIN。

• 输出： 带有国际车辆详细信息（制造商、规格、排放等）的Markdown

______________________________________________________________________

4. get-market-value 💰

• 说明： 通过VIN获取车辆的估计市场价值

• 参数：

- vin （字符串，必填）：17个字符的VIN - state （字符串，可选）：美国州缩写 - mileage （数字，可选）：调整车辆当前里程的市场价值 - condition （字符串，可选）：车辆的整体状况-- excellent, clean, average，或 rough

• 示例提示：

> 多少钱 WBAFR7C57CC811956 价值？

> 我在考虑买VIN WBAFR7C57CC811956 --什么是公平的价格？

> 以旧换新的价值是多少 WBAFR7C57CC811956 在佛罗里达州，有45000英里处于清洁状态？

• 输出： 带市值细分的Markdown（零售、折价、MSRP等）

______________________________________________________________________

5. get-vehicle-history 🕓

• 说明： 按VIN获取全面的车辆历史报告

• 参数：

- vin （字符串，必填）：17个字符的VIN - format （字符串，可选）：响应格式（json或xml）

• 示例提示：

> 有 WBAFR7C57CC811956 你出过事故吗？

> 显示VIN的完整历史记录 WBAFR7C57CC811956

> 有多少业主 WBAFR7C57CC811956 有？

• 输出： 带有历史记录的Markdown（垃圾/打捞、保险、品牌、标题、里程表等）

______________________________________________________________________

6. get-vehicle-images 🖼️

• 说明： 按品牌、型号和过滤器获取车辆图像

• 参数：

- make （字符串，必填） - model （字符串，必填） - year, trim, color, transparent, angle, photoType, size, license, format （全部可选）

• 示例提示：

> 给我看2018年丰田塔科马的蓝色照片

> 获取2022年福特野马GT的红色图片

> 2020款白色特斯拉Model 3是什么样子的？

• 输出： Markdown最多可包含5张图片（链接、缩略图、详细信息）

______________________________________________________________________

7. get-vehicle-recalls 🚨

• 说明： 按VIN获取车辆召回信息

• 参数：

- vin （字符串，必填）：17个字符的VIN

• 示例提示：

> 是否 1C4JJXR64PW696340 有公开召回吗？

> 我刚买了VIN 1C4JJXR64PW696340 --我应该担心召回吗？

> 检查是否有安全召回 WBAFR7C57CC811956

• 输出： 带有召回详细信息（日期、描述、风险、补救措施、状态等）的Markdown

______________________________________________________________________

8. recognize-plate-image 🏷️

• 说明： 从车辆图像URL中识别和提取车牌

• 参数：

- imageUrl （string，必填）：指向车辆牌照图像的直接URL

• 示例提示：

> 这张图片中的车牌号是多少？ https://api.carsxe.com/img/apis/plate_recognition.JPG

> 请阅读这张照片中的车牌： [image URL]

• 输出： 带有检测到的车牌、置信度评分、边界框、车辆类型等的Markdown。

______________________________________________________________________

9. vin-ocr 🔍

• 说明： 使用OCR从车辆图像中提取VIN

• 参数：

- imageUrl （字符串，必填）：指向车辆VIN图像的直接URL

• 示例提示：

> 从该图像中提取VIN： https://user-images.githubusercontent.com/5663423/30922082-64edb4fa-a3a8-11e7-873e-3fbcdce8ea3a.png

> 这张照片中的VIN是什么？ https://res.cloudinary.com/carsxe/image/upload/q_auto/f_auto/v1713204144/base/images/vin-ocr/vin.jpg

• 输出： 带有检测到的VIN、置信度、边界框和候选者的Markdown

______________________________________________________________________

10. get-year-make-model 📅

• 说明： 按年份、品牌、型号和可选装饰获取全面的车辆信息

• 参数：

- year （字符串，必填） - make （字符串，必填） - model （字符串，必填） - trim （字符串，可选）

• 示例提示：

> 2020年丰田凯美瑞的规格是什么？

> 请介绍一下2019年本田思域运动版的内饰

> 2021款福特F-150有哪些颜色？

• 输出： 带有车辆详细信息、颜色、功能、选项和包装的Markdown

______________________________________________________________________

11. decode-obd-code 🛠️

• 说明： 解码OBD代码并获取诊断信息

• 参数：

- code （字符串，必填）：OBD代码（例如P0115）

• 示例提示：

> 我的检查发动机灯亮着，有代码 P0115 --这是什么意思？

> 解码OBD代码 P0300

> 我有一个 C1234 我仪表板上的代码——严重吗？

• 输出： 带有代码、诊断和日期的Markdown

______________________________________________________________________

12. get-lien-theft 🔒

• 说明： 通过VIN获取车辆的留置权和盗窃信息

• 参数：

- vin （字符串，必填）：17个字符的车辆识别号

• 示例提示：

> 是否存在留置权 WBAFR7C57CC811956?

> 我要买一辆有VIN的二手车 WBAFR7C57CC811956 --检查它是否被盗

> 验证标题是否干净 WBAFR7C57CC811956

• 输出： 带有留置权持有人信息、盗窃记录、追回日期和状态的Markdown

______________________________________________________________________

🔗 链式工具——高级用户示例

CarsXE MCP的真正力量来自于在一次对话中链接工具：

情景1——购前尽职调查：

1. > 解码板 7XER187 在加州
2. > 现在了解它的完整历史
3. > 它有公开召回吗？
4. > 如果我今天买它值多少钱？

场景2——在街上发现一辆车：

1. > 从这张图片中读取印版： [photo URL]
2. > 看看得克萨斯州的那个盘子
3. > 给我看那辆车的照片

场景3——机修工/维修车间：

1. > 从仪表板照片中解码此VIN： [image URL]
2. > 获取其完整规格
3. > 我的客户说检查发动机代码是P0300——这对这辆车意味着什么？

______________________________________________________________________