Smartcar MCPサーバー

MCP (Model Context Protocol)サーバーであり、Smartcarの車両APIをAIエージェント用のツールとして公開します。Claude、ChatGPT、およびその他のMCP互換クライアントが、自然言語を使用して車両のテレメトリを照会し、コマンドを送信できるようにします。

概要

このサーバーは、OAuth2クライアント認証情報を使用してSmartcarのM2M（マシン間）APIをラップします。トークンの取得とキャッシュを自動的に処理するため、AIエージェントは認証を管理することなく車両とやり取りできます。

4つのカテゴリにわたる16のツール:

Related MCP server: agentforge

使用方法

インストールは不要です。これを claude_desktop_config.json（または同等のMCPクライアント設定）に追加してください：

{
  "mcpServers": {
    "smartcar": {
      "command": "npx",
      "args": ["-y", "smartcar-mcp"],
      "env": {
        "SMARTCAR_CLIENT_ID": "your-client-id",
        "SMARTCAR_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

環境変数

開発

git clone https://github.com/thachdoSC/smartcar-mcp-test
cd smartcar-mcp
npm install
npm run dev   # run from source
npm run build # compile to dist/

ツールリファレンス

接続

list_connections — オプションのフィルターを使用して車両接続を一覧表示します。

get_connection — IDで単一の接続を取得します。

delete_connection — IDで接続を削除します。

delete_user — ユーザーと関連するすべてのデータを削除します。

信号（テレメトリ）

get_signals — 車両で利用可能なすべての信号を一覧表示します。

get_signal — 特定の信号の現在の値を取得します。

充電: charge.ischarging, charge.voltage, charge.wattage, charge.amperage, charge.limit, charge.estimation.durationtocompletion, charge.estimation.distance_added, charge.estimation.kwh_added, charge.estimation.percent_added, charge.session.id, charge.session.starttime, charge.session.endtime, charge.session.kwhadded, charge.session.milesadded, charge.session.porttype, charge.session.cost, charge.schedule.type, charge.schedule.starttime, charge.schedule.day, charge.schedule.enabled, charge.porttype, charge.portstatus

空調: climate.externaltemperature, climate.internaltemperature

開閉部: closure.door, closure.lock, closure.window, closure.sunroof, closure.fronttrunk, closure.reartrunk, closure.chargeport

接続性: connectivity.firmware, connectivity.isonline, connectivity.sleepstate, connectivity.lastseenat

診断: diagnostics.faultcodes, diagnostics.oil, diagnostics.emissions, diagnostics.abs, diagnostics.airbag, diagnostics.battery.maintenancestatus, diagnostics.battery.range, diagnostics.battery.soc, diagnostics.brakebooster, diagnostics.brakefluid, diagnostics.collision, diagnostics.coolant, diagnostics.cruisecontrol, diagnostics.enginelight, diagnostics.hazardlights, diagnostics.headlights, diagnostics.park, diagnostics.stabilitycontrol, diagnostics.steeringlock, diagnostics.transmission, diagnostics.washerfluid

HVAC: hvac.cabintemperature, hvac.defroster, hvac.heater, hvac.temperatureset, hvac.ventilation

ICE（内燃機関）: ice.fuel.level, ice.fuel.range, ice.fuel.percentremaining, ice.oillife

位置情報: location.precise, location.ishome

低電圧バッテリー: lowvoltagebattery.stateofcharge, lowvoltagebattery.status

動作: motion.speed

オドメーター: odometer.distance

サービス: service.isinservice, service.records

監視: surveillance.brand, surveillance.isenabled

トラクションバッテリー: tractionbattery.stateofcharge, tractionbattery.range, tractionbattery.heating, tractionbattery.capacity.kwh, tractionbattery.capacity.usableKwh, tractionbattery.limit, tractionbattery.temperature, tractionbattery.chargecompletiontime, tractionbattery.fullchargetime

トランスミッション: transmission.drivemode, transmission.gear

車両ID: vehicleid.vin, vehicleid.color, vehicleid.trim, vehicleid.packages, vehicleid.nickname

車両ユーザーアカウント: vehicleuseraccount.grantedpermissions, vehicleuseraccount.role

ホイール: wheel.style, wheel.tires

車両コマンド

すべてのコマンドツールには vehicle_id と user_id が必要です。

lock_vehicle — 車両のドアをロックします。

unlock_vehicle — 車両のドアをアンロックします。

start_charge — EV充電を開始します。

stop_charge — EV充電を停止します。

set_charge_limit — 最大充電レベルを設定します。

set_navigation_destination — 車両のナビゲーションシステムにGPS目的地を送信します。

管理

list_applications — 組織内のすべてのSmartcarアプリケーションを一覧表示します。

get_application — IDで特定のアプリケーションの詳細を取得します。

list_application_secrets — アプリケーションの認証情報を一覧表示します（シークレット値は返されません）。

プロジェクト構造

src/
├── index.ts          # Server entry point — wires up tools and transport
├── auth.ts           # OAuth2 token manager with in-memory caching
├── client.ts         # HTTP client for Smartcar REST APIs
└── tools/
    ├── connections.ts # Connection and user management tools
    ├── signals.ts     # Vehicle telemetry tools
    ├── commands.ts    # Vehicle control command tools
    └── management.ts  # Application management tools

認証

サーバーはOAuth2クライアント認証情報（M2Mフロー）を使用します。トークンはメモリにキャッシュされ、有効期限の60秒前に自動的に更新されます。手動でのトークン管理は不要です。