Car2db Api V3 MCP

🚀 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の設定

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パッケージ（ワンクリックインストール）

Claude Desktopや他のMCPクライアントで簡単にインストールできるよう、事前にビルドされたMCPB拡張機能をダウンロードします。 car2db-api-v3-mcp.mcpbをダウンロード

MCPBは、ローカルMCPサーバーとサーバーおよびその機能を記述するmanifest.jsonを含むZIPアーカイブです。ダウンロードしてワンクリックでインストールできます。

インストール手順:

1. GitHubのリリースから.mcpbファイルをダウンロードします。
2. ファイルをダブルクリックするか、MCPクライアントにドラッグアンドドロップします。
3. セットアップダイアログでAPIキーを設定します（オプション。設定しない場合はデモキーが使用されます）。
4. 「インストール」をクリックして拡張機能を使用を開始します。

GitHub Releases: 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: 1ページあたりのアイテム数（デフォルト: 30）

💻 使用例

例1: 特定の車両仕様を検索する

Claude: "2020年のBMW X5 xDrive40iの仕様は何ですか？"

エージェントのワークフロー:
1. search_vehicles(q: "BMW X5 xDrive40i 2020")
2. get_trim_full(trimId: <検索結果から>)
3. 返却: パンくずリスト、主要仕様、完全な仕様、利用可能な装備

例2: 装備パッケージを比較する

Claude: "2023年のToyota Camryの装備パッケージを比較してください。"

エージェントのワークフロー:
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: "すべてのTeslaモデルを表示してください。"

エージェントのワークフロー:
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: "2024年に利用可能な電気SUVは何ですか？"

エージェントのワークフロー:
1. get_year_vehicles(year: 2024, typeId: 1)
2. 電気パワートレインをフィルタリング
3. SUVボディタイプをフィルタリング
4. 結果を表示

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-server
• Car2DB API: https://car2db.com/api/
• Model Context Protocol: https://modelcontextprotocol.io/

サポート

API関連の質問やサポートについては、以下の方法でお問い合わせください。

• メール: support@car2db.com
• ウェブサイト: https://car2db.com
• Telegram: https://t.me/car2db_support_bot

MCPサーバーの問題については、以下のGitHub Issuesをご利用ください。

• GitHub Issues: https://github.com/car2db/car2db-api-v3-mcp/issues