Witzense MCP
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 defectohttp://open.10000track.com/route/rest.WITZENSE_APP_KEYyWITZENSE_APP_SECRET.WITZENSE_ACCOUNTyWITZENSE_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:formpor defecto, ojsonsi 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 startEl servidor se comunica a través de MCP stdio. Las herramientas disponibles incluyen:
call_witzense_methodlist_witzense_child_accountslist_witzense_devicesget_witzense_deviceget_witzense_device_locationslist_witzense_account_locationsget_witzense_trackget_witzense_mileageget_witzense_shared_location_urllist_witzense_alarmsget_witzense_parking_reportget_witzense_trips_reportget_witzense_fence_duration_reportget_witzense_obd_dataget_witzense_obd_faultsget_witzense_rfid_reportsget_witzense_tag_locationlist_witzense_geofencesget_witzense_geofencelist_witzense_device_groupsget_witzense_media_urlsget_witzense_live_urlget_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 testDespliegue 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 toolscall_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_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
Scored across 23 tools
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.
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.
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.
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
Read vehicles, positions, idle time, fault codes, driving scores and alerts in GPS Insight.
GPS trackers, phones and QR tags: locations, trips, alerts and vehicle controls with user consent.
Read vehicle positions, trips, events, drivers and orders; create addresses in Webfleet.
Read-only access to a Zoopit account: orders, routes, fleet and live vehicle positions.
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceProvides 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.10MIT
- AlicenseAqualityDmaintenanceEnables access to SORACOM IoT platform data including Harvest sensor data, file storage, SoraCam camera footage/events, and SIM statistics through authenticated API calls.5MIT
- FlicenseAqualityFmaintenanceEnables interaction with InvenTree inventory management system, providing tools for parts, stock, orders, companies, barcodes, labels, reports, attachments, and system administration.121-

Cariot MCP Serverofficial
AlicenseBqualityCmaintenanceEnables querying Cariot APIs for fleet management data, including alcohol checks, daily reports, drivers, vehicles, and realtime snapshots, with utility for generating chart configurations.711 npm1MIT