Vincario Vehicle Data

Vincario MCP サーバー

AI エージェントと LLM クライアントに Vincario API を公開する MCP（Model Context Protocol） サーバーです。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 クライアントに接続する

リクエストごとに、Vincario API キーを HTTP ヘッダーとして渡します。

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」
• 「85000 km 走行した VIN WBAFR9C54BC780006 の市場価格はいくらですか？」

トランスポート

このサーバーはストリーミング可能な HTTP トランスポート（stateless_http=True）を使用するため、永続的なセッションは必要ありません。各リクエストは独立しているため、リバースプロキシやロードバランサーの背後に簡単にデプロイできます。

HTTPS でデプロイする場合は、リバースプロキシ（nginx、Caddy、Cloudflare）をサーバーの前に配置してください。アプリケーション自体は通常の HTTP ポート 8080 で動作します。

ライセンス

利用条件については、Vincario API の利用規約をご覧ください。