Smartcar MCP-Server

Ein MCP (Model Context Protocol)-Server, der die Fahrzeug-API von Smartcar als Tools für KI-Agenten bereitstellt. Ermöglicht es Claude, ChatGPT und anderen MCP-kompatiblen Clients, Fahrzeugtelemetrie abzufragen und Befehle in natürlicher Sprache zu senden.

Übersicht

Dieser Server kapselt die M2M-API (Machine-to-Machine) von Smartcar unter Verwendung von OAuth2-Client-Anmeldeinformationen. Er übernimmt die Token-Beschaffung und das Caching automatisch, sodass KI-Agenten mit Fahrzeugen interagieren können, ohne die Authentifizierung verwalten zu müssen.

16 Tools in 4 Kategorien:

Related MCP server: agentforge

Verwendung

Keine Installation erforderlich. Fügen Sie dies zu Ihrer claude_desktop_config.json (oder einer entsprechenden MCP-Client-Konfiguration) hinzu:

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

Umgebungsvariablen

Entwicklung

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/

Tool-Referenz

Verbindungen

list_connections — Auflisten von Fahrzeugverbindungen mit optionalen Filtern.

get_connection — Abrufen einer einzelnen Verbindung nach ID.

delete_connection — Löschen einer Verbindung nach ID.

delete_user — Löschen eines Benutzers und aller zugehörigen Daten.

Signale (Telemetrie)

get_signals — Auflisten aller verfügbaren Signale für ein Fahrzeug.

get_signal — Abrufen des aktuellen Werts eines bestimmten Signals.

Laden: 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

Klima: climate.externaltemperature, climate.internaltemperature

Verschluss: closure.door, closure.lock, closure.window, closure.sunroof, closure.fronttrunk, closure.reartrunk, closure.chargeport

Konnektivität: connectivity.firmware, connectivity.isonline, connectivity.sleepstate, connectivity.lastseenat

Diagnose: 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 (Verbrennungsmotor): ice.fuel.level, ice.fuel.range, ice.fuel.percentremaining, ice.oillife

Standort: location.precise, location.ishome

Niederspannungsbatterie: lowvoltagebattery.stateofcharge, lowvoltagebattery.status

Bewegung: motion.speed

Kilometerzähler: odometer.distance

Service: service.isinservice, service.records

Überwachung: surveillance.brand, surveillance.isenabled

Traktionsbatterie: tractionbattery.stateofcharge, tractionbattery.range, tractionbattery.heating, tractionbattery.capacity.kwh, tractionbattery.capacity.usableKwh, tractionbattery.limit, tractionbattery.temperature, tractionbattery.chargecompletiontime, tractionbattery.fullchargetime

Getriebe: transmission.drivemode, transmission.gear

Fahrzeug-ID: vehicleid.vin, vehicleid.color, vehicleid.trim, vehicleid.packages, vehicleid.nickname

Fahrzeugbenutzerkonto: vehicleuseraccount.grantedpermissions, vehicleuseraccount.role

Rad: wheel.style, wheel.tires

Fahrzeugbefehle

Alle Befehls-Tools erfordern vehicle_id und user_id.

lock_vehicle — Fahrzeugtüren verriegeln.

unlock_vehicle — Fahrzeugtüren entriegeln.

start_charge — EV-Ladevorgang starten.

stop_charge — EV-Ladevorgang stoppen.

set_charge_limit — Maximalen Ladestand festlegen.

set_navigation_destination — Ein GPS-Ziel an das Navigationssystem des Fahrzeugs senden.

Verwaltung

list_applications — Alle Smartcar-Anwendungen in Ihrer Organisation auflisten.

get_application — Details für eine bestimmte Anwendung nach ID abrufen.

list_application_secrets — Anmeldeinformationen für eine Anwendung auflisten (geheime Werte werden nicht zurückgegeben).

Projektstruktur

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

Authentifizierung

Der Server verwendet OAuth2-Client-Anmeldeinformationen (M2M-Flow). Token werden im Arbeitsspeicher zwischengespeichert und 60 Sekunden vor Ablauf automatisch aktualisiert. Es ist keine manuelle Token-Verwaltung erforderlich.