Car2db Api V3 MCP

🚀 Car2DB MCP Server

Car2DB MCP Server是适用于Car2DB API v3的MCP（Model Context Protocol）服务器，它允许LLM代理（如Claude、ChatGPT、Cursor、VSCode）直接与汽车数据库进行交互。

✨ 主要特性

• 完整的车辆数据库 — 可访问汽车、摩托车和卡车的详细规格信息。
• 智能搜索 — 支持使用自然语言进行车辆搜索。
• 丰富的数据 — 提供技术规格、装备包和详细特性等信息。
• 多语言支持 — 支持11种语言。
• 双传输模式 — 支持stdio（Claude Desktop/Cursor）和SSE（远程访问）两种传输模式。
• 支持Docker — 可进行生产级的容器化部署。

🚀 快速开始

Claude Desktop配置

在claude_desktop_config.json中添加以下内容：

{
  "mcpServers": {
    "car2db": {
      "command": "npx",
      "args": ["-y", "@car2db/mcp-server"],
      "env": {
        "CAR2DB_API_KEY": "your_api_key_here",
        "CAR2DB_REFERER": "https://yourproject.com",
        "CAR2DB_LANGUAGE": "en-US"
      }
    }
  }
}

获取API密钥：https://car2db.com/api/ 试用演示密钥：https://car2db.com/api-token-demo/

GitHub Copilot配置

在项目的.vscode/mcp.json配置文件中使用以下内容：

{
  "servers": {
    "car2db": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "CAR2DB_API_KEY": "your_api_key_here",
        "CAR2DB_REFERER": "https://yourproject.com",
        "CAR2DB_LANGUAGE": "en-US",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

或者使用npx进行零安装：

{
  "mcpServers": {
    "car2db": {
      "command": "npx",
      "args": ["-y", "@car2db/mcp-server"],
      "env": {
        "CAR2DB_API_KEY": "your_api_key_here",
        "CAR2DB_REFERER": "https://yourproject.com",
        "CAR2DB_LANGUAGE": "en-US"
      }
    }
  }
}

获取API密钥：https://car2db.com/api/
试用演示密钥：https://car2db.com/api-token-demo/

📦 安装指南

1. MCPB包（一键安装）

下载预构建的MCPB扩展，可在Claude Desktop或其他MCP客户端中轻松安装： 下载car2db-api-v3-mcp.mcpb MCPB是一个ZIP存档，包含本地MCP服务器和描述服务器及其功能的manifest.json，只需下载并一键安装即可。

安装步骤：

1. 从GitHub版本中下载.mcpb文件。
2. 双击该文件或将其拖入MCP客户端。
3. 在设置对话框中配置API密钥（可选，如果未提供将使用演示密钥）。
4. 点击“安装”并开始使用该扩展。 GitHub版本：https://github.com/car2db/car2db-api-v3-mcp/releases

2. npx（零安装）

npx @car2db/mcp-server

3. 全局npm安装

npm install -g @car2db/mcp-server
car2db-mcp

4. 本地开发

git clone https://github.com/car2db/car2db-api-v3-mcp.git
cd car2db-api-v3-mcp
npm install
npm run build
npm start

5. Docker（适用于SSE模式）

docker-compose up -d

或者手动操作：

docker build -t car2db-mcp .
docker run -p 3000:3000 \
  -e CAR2DB_API_KEY=your_key \
  -e CAR2DB_REFERER=https://yourproject.com \
  car2db-mcp

📚 详细文档

配置

环境变量

Referer头

Car2DB API要求每个请求都包含Referer头。将CAR2DB_REFERER设置为使用此MCP服务器的项目或网站的URL。此URL必须与在car2db.com上注册的API密钥的URL匹配。 如果未设置CAR2DB_REFERER，启动时会打印警告信息，并且API请求将返回403 Forbidden。

示例.env文件

CAR2DB_API_KEY=your_api_key_here
CAR2DB_REFERER=https://yourproject.com
CAR2DB_LANGUAGE=en-US
MCP_TRANSPORT=stdio

可用工具

智能工具（高级）

底层工具（直接API访问）

工具参数参考

• typeId：车辆类型过滤器
  • 1 = 汽车
  • 2 = 摩托车
  • 3 = 卡车
• page：页码（默认值：1）
• itemsPerPage：每页显示的项目数（默认值：30）

SSE模式（远程访问）

对于远程访问或与Web服务集成，可使用SSE传输：

启动SSE服务器

export MCP_TRANSPORT=sse
export MCP_SSE_PORT=3000
npm start

或者使用Docker：

docker-compose up -d

SSE端点

• SSE连接：GET http://localhost:3000/sse
• 消息：POST http://localhost:3000/messages
• 健康检查：GET http://localhost:3000/health

API覆盖范围

此MCP服务器提供对Car2DB API v3端点的访问：

• /search/vehicles — 车辆搜索
• /makes — 制造商列表
• /models — 车辆车型
• /generations — 车型代系
• /series — 车身样式系列
• /trims — 发动机/变速器车型
• /trims/{id}/full — 完整的车型数据
• /equipments/{id}/full — 装备套餐
• /years/{year} — 按年份列出车辆 基础URL：https://v3.api.car2db.com

开发

构建

npm run build

类型检查

npm run typecheck

开发模式

npm run dev

获取API访问权限

• 购买API密钥：https://car2db.com/api/
• 试用演示密钥：https://car2db.com/api-token-demo/
• API文档：https://v3.api.car2db.com/docs

要求

• Node.js >= 20.0.0
• 有效的Car2DB API密钥

💻 使用示例

示例1：查找特定车辆规格

Claude: "What are the specifications of 2020 BMW X5 xDrive40i?"

代理工作流程：
1. search_vehicles(q: "BMW X5 xDrive40i 2020")
2. get_trim_full(trimId: <from_search_results>)
3. 返回：面包屑导航、关键规格、完整规格、可用装备

示例2：比较装备套餐

Claude: "Compare equipment packages for Toyota Camry 2023"

代理工作流程：
1. search_vehicles(q: "Toyota Camry 2023")
2. get_trim_full(trimId: ...) → 获取装备列表
3. get_equipment_full(equipmentId: A) → 套餐A选项
4. get_equipment_full(equipmentId: B) → 套餐B选项
5. 比较并展示差异

示例3：浏览目录

Claude: "Show me all Tesla models"

代理工作流程：
1. browse_catalog(level: "makes") → 查找Tesla
2. browse_catalog(level: "models", makeId: 56) → 所有Tesla车型
3. browse_catalog(level: "trims", modelId: 789) → Model 3的车型

示例4：按年份搜索

Claude: "What electric SUVs were available in 2024?"

代理工作流程：
1. get_year_vehicles(year: 2024, typeId: 1)
2. 过滤电动动力系统
3. 过滤SUV车身类型
4. 展示结果

📄 许可证

本项目采用MIT许可证。

🔗 链接

• 仓库：https://github.com/car2db/car2db-api-v3-mcp
• npm包：https://www.npmjs.com/package/@car2db/mcp-server
• Car2DB API：https://car2db.com/api/
• 模型上下文协议：https://modelcontextprotocol.io/

🛠️ 支持

API相关问题和支持

• 邮箱：support@car2db.com
• 网站：https://car2db.com
• Telegram：https://t.me/car2db_support_bot

MCP服务器问题

• GitHub问题：https://github.com/car2db/car2db-api-v3-mcp/issues