Flespi MCP Server

Interaja com a API da plataforma de telemática Flespi para gerenciamento de frotas, rastreamento de dispositivos e processamento de dados de telemetria.

GitHub
2
Experimente este MCPPatrocinado

Documentação

Flespi MCP Server

MCP Compatible Node.js License: MIT

Um servidor MCP (Model Context Protocol) para a API completa da Flespi, que permite que os LLMs interajam com a plataforma de telemática Flespi.

✨ Principais Características

  • 🔧 157 ferramentas MCP geradas automaticamente a partir da API da Flespi
  • 🚀 Plug & Play - Compatível com todos os principais clientes MCP
  • 📊 API Completa - Acesso a todos os endpoints da Flespi
  • 🛡️ Validação robusta - Esquemas tipados com Zod
  • 📝 Logging estruturado - Debugging e monitoramento completo
  • 🔐 Autenticação segura - Suporte para tokens da Flespi

Características

  • API Completa: Expõe todos os endpoints da API da Flespi como ferramentas para LLMs
  • Autenticação: Suporte completo para tokens de autenticação da Flespi
  • Recursos Principais:
    • Devices: Gestão de dispositivos de rastreamento
    • Channels: Canais de entrada para protocolos de telemetria
    • Streams: Transmissão de dados para sistemas externos
    • Calculators: Motor de análise e relatórios
    • Assets: Entidades virtuais para acompanhamento multi-dispositivo
    • Plugins: Extensões de funcionalidade
    • Geofences: Geocercas para análise geoespacial
    • Groups: Organização e gestão em massa
    • Modems: Envio de SMS e comandos

🚀 Instalação Rápida

# 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

🔧 Compatibilidade MCP

Este servidor é compatível com todos os principais clientes MCP:

ClienteSuporteNotas
Claude Desktop✅Configuração local
Claude.ai✅Servidores remotos
Cursor✅Ferramentas integradas
VS Code Copilot✅Descoberta dinâmica
Continue✅Ferramentas e recursos
Cline✅Suporte completo

📋 Certificado MCP: Este servidor atende 100% à especificação MCP v1.0

Configuração

Obter Token da Flespi

  1. Registre-se em flespi.io
  2. Vá para a seção "Tokens" no seu painel de controle
  3. Crie um novo token com as permissões necessárias
  4. Copie o token para usá-lo nas chamadas à API

Configuração no seu cliente MCP

Adicione o servidor à sua configuração MCP (exemplo para Claude Desktop):

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

Uso

Ferramentas Disponíveis

O servidor expõe automaticamente todas as operações da API da Flespi como ferramentas MCP. Os nomes das ferramentas seguem o padrão:

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

Exemplos:

  • flespi_get_devices - Listar dispositivos
  • flespi_post_devices - Criar novos dispositivos
  • flespi_get_devices_messages - Obter mensagens de dispositivos
  • flespi_put_channels - Atualizar canais
  • flespi_delete_streams - Excluir streams

Ferramentas Especiais

  • flespi_get_protocols - Obtém protocolos disponíveis, tipos de dispositivos, etc.
  • flespi_list_tools - Lista todas as ferramentas disponíveis com categorização

🔍 157 Ferramentas no Total

  • 155 operações da API da Flespi
  • 2 ferramentas utilitárias
  • 77 parâmetros globais com documentação detalhada
  • 38 seletores especializados com exemplos de uso

Parâmetros Comuns

Todas as ferramentas exigem:

  • token - Seu token de autenticação da Flespi

Parâmetros adicionais conforme o endpoint:

  • Parâmetros de rota (como device_id, channel_id)
  • Parâmetros de consulta (como fields, limit, offset)
  • body - Dados do corpo da requisição (para POST/PUT/PATCH)

Exemplos de Uso

Listar Dispositivos

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

Criar um Novo Canal

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

Obter Mensagens de um Dispositivo

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

🎯 Exemplos de Seletores

Os seletores na Flespi permitem filtrar e selecionar recursos específicos:

Seletores de Dispositivos

// 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"

Seletores de Assets

// 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"

Casos de Uso Comuns

Gestão de Frota

  • Monitorar localizações de veículos em tempo real
  • Gerar relatórios de atividade
  • Configurar geocercas para alertas
  • Gerenciar dispositivos e suas configurações

Análise de Dados

  • Extrair dados históricos de telemetria
  • Calcular métricas personalizadas
  • Gerar relatórios automáticos
  • Detectar padrões de comportamento

Integração de Sistemas

  • Sincronizar dados com sistemas externos
  • Automatizar fluxos de trabalho
  • Criar dashboards personalizados
  • Implementar notificações

Recursos da Flespi

Documentação

🤝 Contribuir

As contribuições são bem-vindas! Por favor:

  1. Faça fork do projeto
  2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
  3. Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
  4. Faça push para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📄 Licença

Este projeto está sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🙏 Agradecimentos

📞 Suporte

  • 📧 Issues: GitHub Issues
  • 📖 Documentação: Veja MCP_COMPLIANCE_REPORT.md para detalhes técnicos
  • 🔧 Testes: Use npx @modelcontextprotocol/inspector node server.js

Feito com ❤️ para a comunidade MCP

Ferramentas

Limitações

  • Requer conexão com a internet para se comunicar com a API da Flespi
  • Sujeito aos limites de taxa da API da Flespi
  • O token deve ter as permissões adequadas para as operações solicitadas

Desenvolvimento

Estrutura do Projeto

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

Executar em Modo de Desenvolvimento

npm run dev

Contribuir

As contribuições são bem-vindas. Por favor:

  1. Abra um issue para discutir mudanças maiores
  2. Faça fork do repositório
  3. Crie uma branch para sua feature
  4. Envie um pull request

Licença

Licença MIT - veja o arquivo LICENSE para mais detalhes.

Suporte

Para problemas com este servidor MCP:

  • Abra um issue neste repositório

Para problemas com a API da Flespi: