Car2db API V3 MCP

Car2DB MCP服务器

](https://www.npmjs.com/package/@car2db/mcp-server) 

用于Car2DB API v3的MCP（模型上下文协议）服务器，使LLM代理（Claude、ChatGPT、Cursor、VSCode）能够直接与汽车数据库交互。

特性

• 整车数据库 --访问汽车、摩托车和卡车的详细规格
• 智能搜索 --自然语言车辆搜索
• 丰富数据 --技术规格、设备包和详细特性
• 多语言 --支持11种语言
• 双重运输 --stdio（克劳德桌面/光标）和SSE（远程访问）
• Docker就绪 --生产就绪的集装箱化

快速开始

Claude桌面配置

添加到您的 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副本配置

对于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是一个包含本地MCP服务器和 manifest.json 描述服务器及其功能——只需单击一下即可下载并安装。

安装步骤：

1. 下载 .mcpb GitHub发布的文件
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

配置

环境变量

裁判头

Car2DB API需要 Referer 每个请求中的标头。集 CAR2DB_REFERER 指向使用此MCP服务器的项目或站点的URL。此URL必须与上使用API密钥注册的URL匹配 car2db.com.

如果 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）

使用示例

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

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

Agent workflow:
1. search_vehicles(q: "BMW X5 xDrive40i 2020")
2. get_trim_full(trimId: )
3. Returns: breadcrumbs, key specs, full specifications, available equipments

示例2：比较设备包

Claude: "Compare equipment packages for Toyota Camry 2023"

Agent workflow:
1. search_vehicles(q: "Toyota Camry 2023")
2. get_trim_full(trimId: ...) → get equipment list
3. get_equipment_full(equipmentId: A) → package A options
4. get_equipment_full(equipmentId: B) → package B options
5. Compare and present differences

示例3：浏览目录

Claude: "Show me all Tesla models"

Agent workflow:
1. browse_catalog(level: "makes") → find Tesla
2. browse_catalog(level: "models", makeId: 56) → all Tesla models
3. browse_catalog(level: "trims", modelId: 789) → trims for Model 3

示例4：基于年份的搜索

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

Agent workflow:
1. get_year_vehicles(year: 2024, typeId: 1)
2. Filter for electric powertrains
3. Filter for SUV body types
4. Present results

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密钥

许可证

MIT许可证

链接

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

支持

对于API相关的问题和支持：

• 电子邮件：support@car2db.com
• 网站：https://car2db.com
• 电报：https://t.me/car2db_support_bot

对于MCP服务器问题：

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