Bouncie MCP-Server

Ein Model Context Protocol (MCP)-Server für die Bouncie OBD2-Fahrzeugverfolgungs-API. Geben Sie Claude, ChatGPT oder einem anderen MCP-kompatiblen KI-Assistenten Echtzeitzugriff auf Ihre Fahrzeugdaten — Standort, Fahrten, Diagnosen, Kraftstoffstand und mehr.

Was er kann

Verbinden Sie Ihren Bouncie GPS-Tracker mit KI. Stellen Sie Fragen in natürlicher Sprache wie:

• "Wo ist mein Auto gerade?"

• "Zeig mir meine Fahrten von letzter Woche"

• "Leuchtet meine Motorkontrollleuchte? Welche Fehlercodes gibt es?"

• "Wie viel Kraftstoff habe ich noch?"

• "Was war meine längste Fahrt diese Woche?"

Related MCP server: Unoffical Polestar 2 MCP

Funktionen

• Echtzeit-Fahrzeugverfolgung — GPS-Standort, Geschwindigkeit, Fahrtrichtung, Adresse

• Fahrtenverlauf & Analysen — Distanz, Dauer, Durchschnitts-/Maximalgeschwindigkeit, verbrauchter Kraftstoff, Anzahl starker Brems- und Beschleunigungsvorgänge, GPS-Spuren (Polyline oder GeoJSON)

• Fahrzeugdiagnose — Status der Motorkontrollleuchte (MIL), OBD2-Fehlercodes (DTCs), Batteriezustand

• Fahrzeuginformationen — Marke, Modell, Jahr, VIN, Motor, Kilometerstand, Kraftstoffstand

• Multi-User OAuth — Der HTTP-Modus leitet das OAuth von Claude.ai an Bouncie weiter, sodass jeder Benutzer sich mit seinem eigenen Bouncie-Konto authentifiziert

• Stdio + HTTP-Modi — Lokal mit einem vorab ausgestellten Zugriffstoken ausführen oder zentral für mehrere Benutzer hosten

• Docker-bereit — Überall mit HTTPS bereitstellen

Schnellstart

Lokaler (stdio) Modus

npm install && npm run build

Fügen Sie dies zu den MCP-Einstellungen von Claude Desktop oder Claude Code hinzu:

{
  "mcpServers": {
    "bouncie": {
      "command": "node",
      "args": ["/path/to/bouncie-mcp/dist/index.js"],
      "env": {
        "BOUNCIE_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Der Stdio-Modus verwendet ein vorab erhaltenes Bouncie-Zugriffstoken — kein OAuth-Flow erforderlich. Verwenden Sie den HTTP-Modus für Multi-User-Bereitstellungen.

Remote (HTTP) Modus mit Docker

cp .env.example .env  # fill in your credentials
docker compose up -d

Der Server stellt folgende Endpunkte bereit:

• /mcp — MCP-Endpunkt (Bearer-Token-Authentifizierung)

• /authorize — Startet den OAuth-Flow, leitet den Benutzer zu Bouncie weiter

• /callback — Bouncies OAuth-Weiterleitungsziel

• /token — Token-Austausch-Endpunkt für MCP-Clients

• /register — RFC 7591 dynamische Client-Registrierung

• /.well-known/oauth-authorization-server — RFC 8414 Metadaten

• /health — Gesundheitsprüfung

Bouncie App-Einrichtung

1. Registrieren Sie sich unter bouncie.dev und erstellen Sie eine App

2. Notieren Sie sich Ihre Client ID und Ihr Client Secret

3. Setzen Sie die Redirect URL auf {PUBLIC_URL}/callback (z. B. https://bouncie.example.com/callback)

Das ist alles, was im Portal zu tun ist — Benutzer autorisieren sich individuell über den OAuth-Flow, wenn sie sich über Claude.ai verbinden.

Umgebungsvariablen

Stdio-Modus (Einzelbenutzer)

HTTP-Modus (Multi-User)

Tools

get_vehicles

Listet alle Fahrzeuge des Kontos mit Live-Statistiken auf.

Gibt zurück: Fahrzeuginformationen (Marke/Modell/Jahr, VIN, IMEI, Spitzname) und Live-Statistiken (GPS-Standort, Geschwindigkeit, Kraftstoffstand, Kilometerstand, Motorstatus, Batterie, Motorkontrollleuchte, DTCs).

get_vehicle

Ruft ein einzelnes Fahrzeug per VIN oder IMEI ab. Mindestens ein Identifikator ist erforderlich.

get_trips

Ruft den Fahrtenverlauf für ein Fahrzeug ab.

Datumsfenster maximal 1 Woche. Standardmäßig die letzten 7 Tage.

Gibt zurück: Distanz, Dauer, Durchschnitts-/Maximalgeschwindigkeit, verbrauchter Kraftstoff, Anzahl starker Brems-/Beschleunigungsvorgänge, Kilometerstand, GPS-Spur.

get_user

Ruft das Profil des authentifizierten Benutzers ab.

Zeitstempel

Alle Zeitstempel der Bouncie-API sind in UTC. Jedes Fahrzeug/jede Fahrt enthält ein Zeitzonen-Offset-Feld (localTimeZone oder timeZone, z. B. "-0500") für die Umrechnung in die lokale Zeit.

Entwicklung

npm run dev        # Run with tsx (hot reload)
npm run build      # Compile TypeScript
npm test           # Run tests (21 tests)
npm run lint       # Type check

Architektur

• src/index.ts — Stdio-Transport-Einstiegspunkt

• src/http.ts — HTTP/Express-Einstiegspunkt mit OAuth

• src/server.ts — MCP-Tool-Definitionen

• src/api.ts — Bouncie REST-API-Client

• src/oauth.ts — OAuth-Provider, der das OAuth von Claude.ai an Bouncie weiterleitet (PKCE unterstützt)

• src/types.ts — TypeScript-Typen für Fahrzeuge, Fahrten und Webhook-Ereignisse

Bouncie Webhook-Ereignisse

Die Bouncie-API unterstützt auch Webhooks (hier zur Referenz dokumentiert):

Lizenz

MIT