Wheel Fitment API

wheel-size-mcp

Wheel Fitment API の公式MCP サーバーです。API プロバイダーの Wheel-Size.com が開発・保守しています。LLM エージェントが、車両のホイールとタイヤの適合データを利用できます。

AI アシスタントに、次のような質問をしてみましょう。

• 「2024 Toyota Camry の純正ホイールの仕様は？」
• 「5x114.3 18x8 ET35 のリムに適合する車両は？」
• 「7Jx17 ET40 の 225/50R17 に対するインチアップの選択肢を計算して」
• 「このホイールに適合するすべての車両を掲載した商品カードを作成して」

クイックスタート

1. API キーを取得する

developer.wheel-size.com で登録し、API キーをコピーします。

2. シェルに API キーを設定する

~/.zshrc（または ~/.bashrc）に追加します。

export WHEELSIZE_API_KEY="your-api-key-here"

次に、シェルを再読み込みします：source ~/.zshrc

3. AI クライアントに追加する

以下からクライアントを選んでください。各設定ブロックはコピーしてそのまま使用できます。

Claude Code

claude mcp add wheel-size-api -- uvx wheel-size-mcp

または、プロジェクトのルートにある .mcp.json に追加します。

{
  "mcpServers": {
    "wheel-size-api": {
      "command": "uvx",
      "args": ["wheel-size-mcp"],
      "env": {
        "WHEELSIZE_API_KEY": "${WHEELSIZE_API_KEY}"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "wheel-size-api": {
      "command": "uvx",
      "args": ["wheel-size-mcp"],
      "env": {
        "WHEELSIZE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

プロジェクトのルートにある .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "wheel-size-api": {
      "command": "uvx",
      "args": ["wheel-size-mcp"],
      "env": {
        "WHEELSIZE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

{
  "mcpServers": {
    "wheel-size-api": {
      "command": "uvx",
      "args": ["wheel-size-mcp"],
      "env": {
        "WHEELSIZE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Zed

Zed の settings.json に追加します（Cmd+, → 設定を開く）。

{
  "context_servers": {
    "wheel-size-api": {
      "command": {
        "path": "uvx",
        "args": ["wheel-size-mcp"],
        "env": {
          "WHEELSIZE_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

4. クライアントを再起動する

クライアントの起動時に、MCP サーバーが自動的に起動します。

リモートサーバー（Streamable HTTP）

stdio に加えて、サーバーを単独の HTTP サービスとして実行できます。各マシンに Python をインストールする代わりに、1 つのインスタンスを共有してホストする場合に便利です。

wheel-size-mcp --transport http --port 8000

MCP エンドポイントは http://127.0.0.1:8000/mcp/ で提供されます。HTTP 対応クライアントから接続してください。

{
  "mcpServers": {
    "wheel-size-api": {
      "url": "http://127.0.0.1:8000/mcp/"
    }
  }
}

セキュリティ：サーバーはデフォルトで 127.0.0.1 にバインドされます。WHEELSIZE_API_KEY はサーバー側に保存されるため、ポートにアクセスできる人は誰でも API クォータを消費できます。ローカルホスト以外に公開する（--host 0.0.0.0）場合は、認証を処理するリバースプロキシの背後に限定してください。

利用可能なツール（22）

カタログ — 車両の検索

ツール	説明
ws_list_makes	すべてのメーカーを一覧表示します。ここから始めてください。
ws_list_models	メーカーのモデルを一覧表示します（例：Toyota → Camry、Corolla…）。
ws_list_years	メーカー／モデルで利用可能な年式を一覧表示します。
ws_list_generations	メーカー／モデルの世代を一覧表示します（年式の代わりに使用できます）。
ws_list_modifications	特定の車両のグレードを一覧表示します（例：2.0i、3.0 V6…）。
ws_list_regions	市場地域を一覧表示します（USDM、EUDM、JDM…）。

検索 — 適合データ

ツール	説明
ws_search_by_vehicle	車両の純正ホイール／タイヤの仕様を検索します。modification または region に加え、year または generation が必要です（modification が指定されている場合を除く）。
ws_search_by_rim	リム（正確な仕様または最小／最大範囲）に適合する車両を検索します。
ws_search_by_tire	メートル法のタイヤサイズで車両を検索します。速度／荷重／前後異サイズのフィルターと絞り込みファセットを利用できます。
ws_search_by_hf_tire	ハイフローテーション（LT）のインチサイズ（例：31x10.50R15）で車両を検索します。
ws_check_rim_fitment_for_vehicle	「このリムは 2020 Civic に装着できますか？」という質問に、1 回の呼び出しで適合を確認します。
ws_check_tire_fitment_for_vehicle	メートル法のタイヤサイズについて、同様に適合を確認します。
ws_check_hf_tire_fitment_for_vehicle	ハイフローテーションのタイヤサイズについて、同様に適合を確認します。
ws_calculate_upsteps	インチアップ／インチダウン計算ツールです。非対称な直径範囲（steps_min／steps_max）、直径ごとの件数、幅／直径の許容範囲に対応しています。

Classified — EC向け商品カード

ツール	説明
ws_find_tires_for_rim	リムの仕様に適合するタイヤサイズを検索します。
ws_find_vehicles_for_rim	指定したリムに適合する車両を検索します（2Dの幾何学的フィルタリング）。
ws_find_vehicle_modifications_for_rim	特定の世代のトリムまで絞り込みます。
ws_find_vehicles_for_tire	特定のタイヤサイズを使用する車両を検索します。
ws_find_vehicle_modifications_for_tire	そのタイヤを使用する世代のトリムまで絞り込みます。
ws_find_vehicles_for_package	リムとタイヤの組み合わせに適合する車両を検索します。
ws_find_vehicle_modifications_for_package	リムとタイヤのパッケージに対応するトリムまで絞り込みます。

ユーティリティ

ツール	説明
ws_get_spec_metadata	任意の仕様について、算出されたジオメトリ、母集団の統計情報、インテリジェンスのヒントを取得します。

エンジンとパワートレインのデータ

2026-09-15 の API リリース以降、ws_list_modifications、ws_search_by_vehicle、ws_check_*_fitment_for_vehicle ツールが返す各改造情報の行には、並列する 2 つのブロックが含まれます。

• engine — 従来のブロック {fuel, capacity, type, power, code} で、変更はありません。engine.power は代表的な出力値で、電動化レベルに応じて、内燃機関のみの車とマイルドハイブリッドではエンジン出力、フルハイブリッド、プラグインハイブリッド、EV ではシステム出力になります。engine.fuel は表示用の文字列です。グループ化やフィルタリングには、代わりにパワートレインの燃料コードを使用してください。
• powertrain — combustion_engine、electrification_level、primary_fuel、secondary_fuel、engine_power、system_power、engine_power_secondary、motors が含まれます。ws_search_by_vehicle は API から送られた形式のままブロックを返します（出力オブジェクトは {kW, PS, hp}、燃料参照は {code, title}）。一覧取得ツールと適合確認ツールは、トークン数を抑えるため、簡潔な要約（hp の数値、燃料コード、motors [{axle, hp, code}]）を返します。

列挙値や燃料コードにおける「該当なし」を表す語はデータであり、エラーではありません。not_applicable（適用されない — BEV にはエンジンがありません）、not_reported（適用されるが、まだ記録されていません）、unknown（電動化レベルも燃料も記録されていません）。engine_power は内燃機関のみの出力であり、他のほとんどの車両データプロバイダーが「出力」として公開する値です（バイフューエル車では、engine_power_secondary が入力される間、2 つの定格のうち高い方である場合があります）。system_power はパワートレイン全体のメーカー公称出力です。通常、モーターを各車軸に搭載するフルハイブリッド、プラグインハイブリッド、EV 以外では null となり、エンジン出力とモーター出力を加算して算出してはなりません。

ws_list_modifications の fuel フィルターには燃料コード（biodiesel_blend, cng, diesel, e100, electric, ethanol_blend, flex_fuel, h2, hybrid, lpg, petrol, petrol_cng, petrol_lpg）を指定します。1 つの値で従来の engine.fuel、主燃料、または副燃料に一致します。powertrain.primary_fuel / secondary_fuel から取得した実際のコードは、そのまま指定できます。natural-gas などの古い表記も引き続き受け付けられます。「該当なし」を表す語（not_applicable、not_reported、unknown）やその他の値を指定すると、400 エラーになります。

MCP プロンプト

LLM エージェントを複数ステップの操作に導く、事前構築済みのワークフロー用プロンプトです。

プロンプト	説明
vehicle_fitment_lookup	車両の説明から、カタログ→検索までを一貫して実行します
rim_compatibility_check	リムの適合性を確認する、メタデータ→分類のフローです
product_card_generation	ホイール／パッケージ向けのEC商品カード作成ワークフローです

環境変数

変数	必須	デフォルト	説明
WHEELSIZE_API_KEY	はい	—	developer.wheel-size.com の API キー
API_BASE_URL	いいえ	https://api.wheel-size.com	API のベース URL
API_HOST_HEADER	いいえ	—	Host ヘッダーの上書き（ローカルの Docker ルーティングでのみ必要）
MCP_TRANSPORT	いいえ	stdio	stdio または http（--transport と同じ）
MCP_HOST	いいえ	127.0.0.1	http トランスポートのバインドアドレス（--host と同じ）
MCP_PORT	いいえ	8000	http トランスポートのポート（--port と同じ）

API 利用規約

検索ツール（ws_search_by_vehicle、ws_search_by_rim、ws_search_by_tire、ws_search_by_hf_tire、ws_check_*_fitment_for_vehicle チェック）と分類ツール（ws_find_*）は、API 利用規約 に従い、実際のユーザーによって開始される必要があります。自律型エージェントのループや一括データ生成のために呼び出さないでください。カタログツール、ユーティリティツール、および ws_calculate_upsteps には、このような制限はありません。

評価

tests/test_questions.json には、12 のカテゴリ（カタログのナビゲーション、適合情報の検索、逆引き検索、適合チェック、アップステップ計算、E コマースの商品カード、仕様メタデータ、複数ステップのワークフロー、エッジケース、ツール選択）にわたる、自然言語の質問が 89 件含まれています。各エントリには、expected_tools、任意の expected_params / expected_params_search、および自由記述の tests メモが含まれます。

evals/run_evals.py は、MCP ツールを接続した状態でこれらの質問を実際の Claude モデルに渡し、呼び出したツールとそのパラメーターを記録して、期待値に照らして評価します。これにより、ツールの説明やサーバーの指示に関するリグレッションを検出できます。

# needs ANTHROPIC_API_KEY and a reachable Wheel Fitment API; costs money
uv sync --group evals
uv run --group evals python evals/run_evals.py                  # all questions
uv run --group evals python evals/run_evals.py -n 10            # smoke run
uv run --group evals python evals/run_evals.py --category catalog_flow
uv run --group evals python evals/run_evals.py --json report.json --min-pass 0.8

評価は決定的に行われます（LLM による判定はありません）。期待されるすべてのツールが呼び出される必要があります（マルチセット方式で、繰り返しもカウントされます。余分なナビゲーション呼び出しは許容されます）。また、少なくとも 1 回の呼び出しに期待されるパラメーターが含まれている必要があります。機械的にチェックできる期待値がない質問は SKIP として報告され、合格率から除外されます。合格率の推移を比較可能な状態に保つため、デフォルトのモデルは固定されています（claude-sonnet-5）。--model で変更できます。

評価ランナーは pytest や CI の一部ではありません。Anthropic API の利用料金が発生します。評価ロジック自体は CI でユニットテストされています（tests/test_eval_grading.py）。利用規約に関する注意：すべての質問はユーザーが開始したリクエストをシミュレートするため、検索ツールの制限は遵守されています。

開発

# Install dev dependencies
uv sync --dev

# Unit tests (no API needed — this is what CI runs)
uv run pytest -m "not integration"

# Full test suite (requires a private API instance, see note below)
uv run pytest

# Lint
uv run ruff check .

# Run server (stdio)
wheel-size-mcp

テストに関する注意：統合テストは API の非公開テストインスタンスに対して実行され、接続できない場合は自動的にスキップされます。外部コントリビューターは、すべての HTTP 通信をモックし、CI がプッシュやプルリクエストのたびに実行するユニットテストスイート（pytest -m "not integration"）を利用してください。