Witzense MCP

MCP-Server für die Witzense/JIMI-Geräteverfolgungs-Open-API, beschrieben in API DOCUMENT.pdf.

Die extrahierte Markdown-Referenz ist API DOCUMENT.md. Sie bewahrt alle 126 PDF-Seiten als Seitenabschnitte und ist einfacher zu durchsuchen und programmatisch zu verarbeiten. Das PDF bleibt die ursprüngliche Quelle, und nur Bildinhalte sind nicht in die Markdown-Extraktion eingebettet.

Konfiguration

Kopieren Sie .env.example in eine lokale Umgebungskonfiguration und legen Sie fest:

• WITZENSE_BASE_URL: Standardmäßig http://open.10000track.com/route/rest.

• WITZENSE_APP_KEY und WITZENSE_APP_SECRET.

• WITZENSE_ACCOUNT und WITZENSE_PASSWORD_MD5 — das vorhandene 32-stellige MD5 in Kleinbuchstaben des Kontopassworts; geben Sie keinen Klartext an und hashen Sie diesen Wert nicht erneut.

• WITZENSE_EXPIRES_IN: Token-Lebensdauer-Anfrage, von 60 bis 7200 Sekunden.

• WITZENSE_REQUEST_ENCODING: standardmäßig form, oder json, falls der zugewiesene Knoten es erfordert.

Übertragen Sie niemals echte Anmeldedaten und legen Sie sie nicht in Quelldateien ab.

Related MCP server: SORACOM Data Reader MCP

Ausführen

npm install
npm run build
npm start

Der Server kommuniziert über MCP stdio. Verfügbare Werkzeuge umfassen:

• call_witzense_method

• list_witzense_child_accounts

• list_witzense_devices

• get_witzense_device

• get_witzense_device_locations

• list_witzense_account_locations

• get_witzense_track

• get_witzense_mileage

• get_witzense_shared_location_url

• list_witzense_alarms

• get_witzense_parking_report

• get_witzense_trips_report

• get_witzense_fence_duration_report

• get_witzense_obd_data

• get_witzense_obd_faults

• get_witzense_rfid_reports

• get_witzense_tag_location

• list_witzense_geofences

• get_witzense_geofence

• list_witzense_device_groups

• get_witzense_media_urls

• get_witzense_live_url

• get_witzense_rtmp_url

Die dedizierten Werkzeuge sind leseorientiert und verwenden den gemeinsamen signierten Client.

Für Command-Cloud-Integrationen wird jedes Witzense-Gerät/IMEI als entsprechendes Command-Cloud-Asset/Fahrzeug behandelt. Siehe specs/commandcloud-mapping.md.

API-Verhalten

Anfragen verwenden POST /route/rest mit gemeinsamen Parametern, einem Zugriffstoken und einer UTF-8-MD5-Signatur in Großbuchstaben. Tokens werden über jimi.oauth.token.get erworben, über jimi.oauth.token.refresh erneuert und im Speicher zwischengespeichert.

Das PDF listet TS-, TSP-HK-, TSP-EU- und TSP-US-Knoten auf. Konfigurieren Sie den zugewiesenen Knoten über WITZENSE_BASE_URL; ändern Sie den Tool-Code nicht, wenn Sie zwischen Knoten wechseln.

Tests

npm test

Serverbereitstellung

Der Repository-Workflow erstellt und testet Pull-Requests und stellt dann /root/WITZENSE-MCP nach einem Push auf main bereit. Konfigurieren Sie das GitHub-Actions-Geheimnis DEPLOY_SSH_KEY mit dem Bereitstellungsschlüssel, der von root@2.25.109.42 akzeptiert wird.

Halten Sie die Witzense-API-Variablen in der Laufzeitumgebung des Servers oder in der MCP-Host-Konfiguration. Sie sind absichtlich nicht Teil des Bereitstellungs-Workflows oder des Repositorys.

Siehe DEPLOYMENT.md für Bootstrap- und Smoke-Test-Befehle des ersten Servers.