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