Vincario Vehicle Data

Vincario MCP Server

一个 MCP（Model Context Protocol） 服务，可将 Vincario API 提供给 AI Agent 和大模型客户端使用。支持 AI 助手通过自然语言解码 VIN、查询被盗车辆数据库并获取市场估值。

工具

工具	描述
vin_decode	解码 VIN 并返回详细的车辆信息
vin_decode_info	列出给定 VIN 的可用字段（免费端点）
stolen_check	检查 VIN 是否出现在被盗车辆数据库中
vehicle_market_value	获取车辆的市场估值（支持输入里程表读数）

要求

• Vincario API 密钥 — 通过 X-API-Key HTTP 请求头传递
• Docker（推荐），或安装了 uv 的 Python 3.11+

使用 Docker 运行

docker build -t vincario-mcp .
docker run -p 8080:8080 vincario-mcp

服务会在 http://localhost:8080 启动。

在本地运行

pip install uv
uv sync
uv run main.py

连接到 MCP 客户端

每次请求都通过 HTTP 请求头传递 Vincario API 密钥：

X-API-Key: your_api_key_here

Claude Code

将以下内容添加到 MCP 配置中（.mcp.json 或 claude_desktop_config.json）：

{
  "mcpServers": {
    "vincario": {
      "type": "http",
      "url": "http://localhost:8080",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

托管端点

如果要连接到托管服务 https://mcp.vincario.com/mcp，请相应地替换 URL。

使用示例

连接后，你可以向 AI 助手提问：

• “解码 VIN WBAFR9C54BC780006”
• “这辆车是否被盗？VIN：WBAFR9C54BC780006”
• “VIN WBAFR9C54BC780006 的市场价值是多少？里程为 85000 km。”

传输方式

该服务使用可流式传输的 HTTP（stateless_http=True），因此无需持久会话。每个请求都相互独立，因此可以轻松部署在反向代理或负载均衡器后面。

如需通过 HTTPS 部署，请在服务前放置反向代理（nginx、Caddy、Cloudflare）——应用本身通过普通 HTTP 在 8080 端口运行。

许可证

使用条款请参阅 Vincario API 服务条款。