Skip to content

适用于 ADK 的 CarsXE MCP 工具

Supported in ADKPythonTypeScript

CarsXE MCP 服务器将你的 ADK 智能体连接到 CarsXE 车辆数据平台。它将 CarsXE 的 API——VIN 解码和完整规格、车牌解码、市场价值、产权和所有权历史、安全召回、留置权和盗窃记录、OBD-II 故障码解码以及图像查询——暴露为 MCP 工具，你的智能体可以用自然语言调用这些工具，例如"解码 VIN 1HGBH41JXMN109186"或"这辆车有没有未处理的召回？"。

该服务器托管在 https://mcp.carsxe.com/mcp，通过可流式传输的 HTTP 协议提供服务，因此无需本地安装——智能体直接连接到远程端点。

使用场景

  • 解码 VIN 或车牌：将 17 位 VIN 或车牌转换为结构化的品牌、型号、年份、发动机、配置和装备数据，以便智能体对特定车辆进行分析。

  • 评估车辆：获取市场价值、完整的产权和所有权历史以及未处理的安全召回信息，以支持购买、销售和维修决策。

  • 诊断问题：将 OBD-II 故障码（例如 P0300）解码为可读的定义和可能的原因。

  • 读取车辆图像：从照片中提取 VIN 或车牌，并按品牌和型号获取车辆图像。

前提条件

  • 已安装可用的 ADK
  • CarsXE API 密钥——在 api.carsxe.com 注册并复制你的密钥

在智能体中使用

智能体通过可流式传输的 HTTP 连接到托管的 CarsXE MCP 服务器，并通过 X-API-Key 请求头使用你的 API 密钥进行认证。

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams

CARSXE_API_KEY = "YOUR_CARSXE_API_KEY"

root_agent = Agent(
    model="gemini-flash-latest",
    name="carsxe_agent",
    instruction=(
        "你是一个车辆数据助手。使用 CarsXE 工具来解码 "
        "VIN 和车牌，以及查询规格、市场价值、"
        "历史记录、召回信息和 OBD-II 故障码。"
    ),
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.carsxe.com/mcp",
                headers={"X-API-Key": CARSXE_API_KEY},
            ),
        )
    ],
)

import { LlmAgent, MCPToolset } from "@google/adk";

const CARSXE_API_KEY = "YOUR_CARSXE_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "carsxe_agent",
    instruction:
        "你是一个车辆数据助手。使用 CarsXE 工具来解码 " +
        "VIN 和车牌，以及查询规格、市场价值、" +
        "历史记录、召回信息和 OBD-II 故障码。",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mcp.carsxe.com/mcp",
            transportOptions: {
                requestInit: {
                    headers: {
                        "X-API-Key": CARSXE_API_KEY,
                    },
                },
            },
        }),
    ],
});

export { rootAgent };

可用工具

工具 描述
get-vehicle-specs 将 VIN 解码为完整的车辆规格（品牌、型号、年份、发动机、配置、装备）
decode-vehicle-plate 将车牌解码为车辆数据
get-market-value 根据 VIN 估算车辆的市场价值
get-vehicle-history 根据 VIN 获取产权、所有权、事故和里程表历史
get-vehicle-recalls 根据 VIN 检查未处理的安全召回
get-lien-theft 根据 VIN 检查留置权和盗窃记录
international-vin-decoder 解码非美国（国际）VIN
vin-ocr 使用 OCR 从图像中提取 VIN
recognize-plate-image 从图像中识别车牌
get-year-make-model 按年份、品牌和型号查询规格
get-vehicle-images 按品牌和型号获取车辆图像
decode-obd-code 解码 OBD-II 诊断故障码

更多资源