Flespi MCP Server

Interact with the Flespi telematics platform API for fleet management, device tracking, and telemetry data processing.

Un servidor MCP (Model Context Protocol) para la API completa de Flespi, que permite a los LLMs interactuar con la plataforma de telemática Flespi.

- 🔧157 herramientas MCPgeneradas automáticamente desde la API de Flespi
- 🚀Plug & Play- Compatible con todos los clientes MCP principales
- 📊API Completa- Acceso a todos los endpoints de Flespi
- 🛡️Validación robusta- Esquemas tipados con Zod
- 📝Logging estructurado- Debugging y monitoreo completo
- 🔐Autenticación segura- Soporte para tokens de Flespi

- API Completa: Expone todos los endpoints de la API de Flespi como herramientas para LLMs
- Autenticación: Soporte completo para tokens de autenticación de Flespi
- Recursos Principales:

- Devices: Gestión de dispositivos de rastreo
- Channels: Canales de entrada para protocolos de telemetría
- Streams: Transmisión de datos hacia sistemas externos
- Calculators: Motor de análisis e informes
- Assets: Entidades virtuales para seguimiento multi-dispositivo
- Plugins: Extensiones de funcionalidad
- Geofences: Geocercas para análisis geoespacial
- Groups: Organización y gestión masiva
- Modems: Envío de SMS y comandos

# Clonar el repositorio git clone https://github.com/gperezt222/flespi-mcp-server.git cd flespi-mcp-server # Instalar dependencias npm install # Probar el servidor npm test

Este servidor es compatible con todos los clientes MCP principales:

📋Certificado MCP: Este servidor cumple 100% con la especificación MCP v1.0
- Regístrate enflespi.io
- Ve a la sección "Tokens" en tu panel de control
- Crea un nuevo token con los permisos necesarios
- Copia el token para usarlo en las llamadas a la API

{ "mcpServers": { "flespi": { "command": "node", "args": ["/ruta/a/tu/proyecto/server.js"], "cwd": "/ruta/a/tu/proyecto" } } }

El servidor expone automáticamente todas las operaciones de la API de Flespi como herramientas MCP. Los nombres de las herramientas siguen el patrón:

flespi_{método}_{recurso}[_{sub-recurso}]

- flespi_get_devices- Listar dispositivos
- flespi_post_devices- Crear nuevos dispositivos
- flespi_get_devices_messages- Obtener mensajes de dispositivos
- flespi_put_channels- Actualizar canales
- flespi_delete_streams- Eliminar streams

- flespi_get_protocols- Obtiene protocolos disponibles, tipos de dispositivos, etc.
- flespi_list_tools- Lista todas las herramientas disponibles con categorización

- 155 operacionesde la API de Flespi
- 2 herramientasutilitarias
- 77 parámetros globalescon documentación detallada
- 38 selectores especializadoscon ejemplos de uso

- token- Tu token de autenticación de Flespi

Parámetros adicionales según el endpoint:

- Parámetros de ruta (comodevice_id,channel_id)
- Parámetros de consulta (comofields,limit,offset)
- body- Datos del cuerpo de la petición (para POST/PUT/PATCH)

// Herramienta: flespi_get_devices { "token": "tu_token_aqui", "fields": "id,name,ident,enabled" }

// Herramienta: flespi_post_channels { "token": "tu_token_aqui", "body": { "protocol_id": 4, "name": "Mi Canal TCP", "configuration": {} } }

// Herramienta: flespi_get_devices_messages { "token": "tu_token_aqui", "devices.selector": "123456", "count": 100, "fields": "timestamp,position.latitude,position.longitude,speed" }

Los selectores en Flespi permiten filtrar y seleccionar recursos específicos:

// Seleccionar todos los dispositivos "devices.selector": "all" // Seleccionar por IDs específicos "devices.selector": "1,2,3" // Seleccionar por IMEI "devices.selector": "configuration.ident=\"123456789012345\"" // Seleccionar por nombre con wildcards "devices.selector": "name=\"GPS\"" // Seleccionar dispositivos conectados "devices.selector": "connected=true" // Seleccionar por grupo "devices.selector": "groups.id=1234"

// Seleccionar por nombre "assets.selector": "name=\"Truck\"" // Seleccionar por metadata "assets.selector": "metadata.clientid=4" // Seleccionar por último dispositivo asignado "assets.selector": "last.device_id=100"

- Monitorear ubicaciones de vehículos en tiempo real
- Generar informes de actividad
- Configurar geocercas para alertas
- Gestionar dispositivos y sus configuraciones

- Extraer datos históricos de telemetría
- Calcular métricas personalizadas
- Generar informes automáticos
- Detectar patrones de comportamiento

- Sincronizar datos con sistemas externos
- Automatizar flujos de trabajo
- Crear dashboards personalizados
- Implementar notificaciones

- Documentación de la API
- Flespi Platform
- Flespi Blog

Este proyecto está bajo la Licencia MIT - ver el archivoLICENSEpara detalles.

- Flespipor su excelente plataforma de telemática
- Model Context Protocolpor el estándar MCP
- Anthropicpor Claude y el ecosistema MCP

- 📧Issues:GitHub Issues
- 📖Documentación: VerMCP_COMPLIANCE_REPORT.mdpara detalles técnicos
- 🔧Testing: Usanpx @modelcontextprotocol/inspector node server.js

- Guías de Conocimiento
- Protocolos Soportados
- Tipos de Dispositivos

- flespi.io Panel- Interfaz web
- Toolbox- Herramientas de desarrollo
- MQTT Browser- Cliente MQTT
- Setbox- Configuración de dispositivos

. ├── server.js # Servidor MCP principal ├── package.json # Dependencias y scripts ├── flespi.json # Especificación de la API de Flespi └── README.md # Este archivo

- Consulta ladocumentación oficial
- Contacta elsoporte de Flespi

Blynk's MCP server lets AI coding tools create device templates, manage devices, and read live sensor data on the Blynk IoT platform