Skip to main content
Glama

Witzense MCP

Servidor MCP para la API abierta de seguimiento de dispositivos Witzense/JIMI descrita en API DOCUMENT.pdf.

La referencia Markdown extraída es API DOCUMENT.md. Conserva las 126 páginas del PDF como secciones de página y es más fácil de buscar y procesar programáticamente. El PDF sigue siendo la fuente original, y el contenido solo de imágenes no está incrustado en la extracción de Markdown.

Configuración

Copia .env.example a una configuración de entorno local y establece:

  • WITZENSE_BASE_URL: por defecto http://open.10000track.com/route/rest.

  • WITZENSE_APP_KEY y WITZENSE_APP_SECRET.

  • WITZENSE_ACCOUNT y WITZENSE_PASSWORD_MD5 — el MD5 existente de 32 caracteres en minúsculas de la contraseña de la cuenta; no proporciones texto plano y no vuelvas a aplicar hash a este valor.

  • WITZENSE_EXPIRES_IN: solicitud de duración del token, de 60 a 7200 segundos.

  • WITZENSE_REQUEST_ENCODING: form por defecto, o json si el nodo asignado lo requiere.

Nunca confirmes credenciales reales ni las coloques en archivos fuente.

Related MCP server: SORACOM Data Reader MCP

Ejecución

npm install
npm run build
npm start

El servidor se comunica a través de MCP stdio. Las herramientas disponibles incluyen:

  • 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

Las herramientas dedicadas están orientadas a lectura y utilizan el cliente firmado compartido.

Para integraciones con Command Cloud, cada dispositivo/IMEI de Witzense se trata como el activo/vehículo correspondiente de Command Cloud. Consulta specs/commandcloud-mapping.md.

Comportamiento de la API

Las solicitudes usan POST /route/rest con parámetros comunes, un token de acceso y una firma MD5 UTF-8 en mayúsculas. Los tokens se obtienen mediante jimi.oauth.token.get, se renuevan mediante jimi.oauth.token.refresh y se almacenan en caché en memoria.

El PDF enumera los nodos TS, TSP HK, TSP EU y TSP US. Configura el nodo asignado mediante WITZENSE_BASE_URL; no cambies el código de las herramientas al moverte entre nodos.

Pruebas

npm test

Despliegue del servidor

El flujo de trabajo del repositorio compila y prueba las solicitudes de extracción, y luego despliega /root/WITZENSE-MCP después de un push a main. Configura el secreto de GitHub Actions DEPLOY_SSH_KEY con la clave de despliegue aceptada por root@2.25.109.42.

Mantén las variables de la API de Witzense en el entorno de ejecución del servidor o en la configuración del host MCP. Intencionalmente no forman parte del flujo de trabajo de despliegue ni del repositorio.

Consulta DEPLOYMENT.md para los comandos de arranque inicial del servidor y pruebas de humo.

Available Tools

23 tools
call_witzense_methodA

Call a Witzense API method with configured credentials and signing. Use this for documented methods not yet exposed as dedicated tools.

Inputs: method (required), params.

get_witzense_deviceC

Get detail information for one Witzense device.

Inputs: imei (required).

get_witzense_device_locationsB

Get the latest location for one or more Witzense devices.

Inputs: imeis, map_type.

get_witzense_fence_duration_reportC

Get device fence entry and exit duration records.

Inputs: end_time (required), start_time (required), imeis, account, +2 more.

get_witzense_geofenceC

Get details for one platform geofence.

Inputs: fence_id (required).

get_witzense_live_urlC

Get a device live or historical streaming page URL.

Inputs: imei (required), type, voice.

get_witzense_media_urlsC

Get camera photo or video URLs for a device.

Inputs: imei (required), camera (required), media_type (required), token, +4 more.

get_witzense_mileageC

Get mileage trip data for one or more devices.

Inputs: end_time (required), begin_time (required), imeis, page_size, +1 more.

get_witzense_obd_dataC

Get OBD/CAN telemetry reported by devices.

Inputs: end_time (required), start_time (required), imeis, account, +2 more.

get_witzense_obd_faultsC

Get OBD fault codes reported by devices.

Inputs: end_time (required), start_time (required), imeis, account, +2 more.

get_witzense_parking_reportC

Get parking or idling records for devices.

Inputs: acc_type (required), end_time (required), start_time (required), imeis, +3 more.

get_witzense_rfid_reportsC

Get RFID reporting records for an account and time range.

Inputs: account (required), end_time (required), begin_time (required), imeis, +3 more.

get_witzense_rtmp_urlC

Get an RTMP streaming URL for a device.

Inputs: imei (required).

get_witzense_shared_location_urlB

Get a shareable map URL for a Witzense device.

Inputs: imei (required).

get_witzense_tag_locationC

Get the latest location reported by TAG devices.

Inputs: imeis.

get_witzense_trackC

Get track points for one device within the documented time range.

Inputs: imei (required), end_time (required), begin_time (required), map_type.

get_witzense_trips_reportC

Get daily or detailed trip report data.

Inputs: type (required), end_time (required), start_time (required), imeis, +3 more.

list_witzense_account_locationsA

Get the latest location for all devices under an account.

Inputs: target, map_type.

list_witzense_alarmsC

List alarms for one or more devices within the supported time range.

Inputs: imeis, page_no, end_time, page_size, +2 more.

list_witzense_child_accountsB

List sub-accounts under a Witzense account.

Inputs: target.

list_witzense_device_groupsB

List device groups belonging to an account.

Inputs: account (required).

list_witzense_devicesA

List devices belonging to a Witzense account.

Inputs: target.

list_witzense_geofencesB

List platform geofences belonging to an account.

Inputs: account (required), page_no, page_size.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 23 tools

    Disambiguation4/5

    Most tools target clearly distinct resources or actions, such as devices, geofences, reports, and streaming URLs. A few location/trip-related tools (e.g., get_witzense_mileage vs get_witzense_trips_report, or get_witzense_live_url vs get_witzense_rtmp_url) could cause minor selection confusion, but the descriptions are generally sufficient.

    Naming Consistency5/5

    All tools follow a consistent snake_case convention with a clear verb prefix and the witzense domain marker, such as list_witzense_*, get_witzense_*, and call_witzense_method. This creates a predictable pattern across the entire tool set.

    Tool Count3/5

    At 23 tools, the set is on the heavy side and falls into the 16-25 range that feels bulky for an agent to navigate. The tools do cover a broad telematics domain, but the count is somewhat high rather than tightly scoped.

    Completeness4/5

    The tool surface covers a wide range of Witzense capabilities: devices, locations, tracks, reports, geofences, media, alarms, OBD, RFID, and tags. It is mostly read-oriented, but the generic call_witzense_method escape hatch mitigates gaps in dedicated write or management operations.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      Not graded
      maintenance
      Provides access to Alpha ESS solar inverter and battery system data, enabling monitoring of energy statistics, real-time power data, and configuration of battery charging and discharge schedules through the Alpha ESS Open API.
      10
      MIT
    • F
      license
      A
      quality
      F
      maintenance
      Enables interaction with InvenTree inventory management system, providing tools for parts, stock, orders, companies, barcodes, labels, reports, attachments, and system administration.
      12
      1
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables querying Cariot APIs for fleet management data, including alcohol checks, daily reports, drivers, vehicles, and realtime snapshots, with utility for generating chart configurations.
      7
      11 npm
      1
      MIT