Sentinal

Herramientas de monitorización de infraestructura para asistentes de IA. Un solo código base, múltiples plataformas.

Pide a tu asistente de IA que compruebe la salud de Redis, inspeccione las colas de BullMQ, diagnostique consultas lentas, todo a través de una conversación natural.

Plataformas

Plataforma	Distribución	Instalación
Claude, Cursor, Copilot, Cline, Warp, Gemini CLI	Servidor MCP (npm)	`npx @md-musaraf/sentinal-mcp`
OpenClaw	ClawHub	`clawhub install sentinal-redis`
ChatGPT	GPT Store	Próximamente
Raycast	Raycast Store	Próximamente

Módulos

Módulo	Estado	Qué monitoriza
Redis	✅ Listo	Salud del servidor, memoria, consultas lentas, clientes, colas BullMQ
Docker	🔜 Planeado	Salud de contenedores, registros, uso de recursos
Kubernetes	🔜 Planeado	Estado de pods, recuento de reinicios, límites de recursos
GitHub Actions	🔜 Planeado	Ejecuciones de flujos de trabajo, fallos, re-ejecuciones
Vercel	🔜 Planeado	Estado de despliegue, reversiones

Servidor MCP

Funciona con cualquier herramienta de IA que soporte el Protocolo de Contexto de Modelo — Claude Desktop, Claude Code, Cursor, GitHub Copilot, Cline, Warp, Gemini CLI, Continue y más.

Instalación

Añádelo a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "sentinal": {
      "command": "npx",
      "args": ["@md-musaraf/sentinal-mcp"],
      "env": {
        "REDIS_URL": "redis://localhost:6379"
      }
    }
  }
}

Herramientas

Herramienta	Descripción
`redis_ping`	Probar la conectividad con una instancia de Redis
`redis_health`	Informe completo de salud: servidor, memoria, clientes, consultas lentas, colas BullMQ
`redis_memory`	Análisis profundo de memoria con diagnóstico de fragmentación
`redis_slowlog`	Inspeccionar consultas lentas
`bullmq_list`	Listar todas las colas de BullMQ con recuento de trabajos por estado
`bullmq_failed_jobs`	Inspeccionar trabajos fallidos con cargas útiles y seguimientos de pila
`bullmq_job_details`	Detalles completos de un trabajo específico
`bullmq_stale_jobs`	Encontrar trabajos bloqueados en estado activo

Ejemplo de uso

Simplemente pregúntale a tu asistente de IA:

"Comprueba la salud de mi Redis"
"¿Hay alguna cola de BullMQ acumulando trabajos?"
"Muéstrame los trabajos fallidos en la cola email-queue"
"¿Por qué va lento Redis?"
"¿Cuánta memoria está usando Redis?"
"Busca trabajos obsoletos en la cola payment-queue"

Habilidades de OpenClaw

Instala habilidades individuales desde ClawHub:

clawhub install sentinal-redis

La habilidad enseña a tu asistente OpenClaw a monitorizar Redis y BullMQ usando redis-cli. No se requiere código, solo instala y pregunta.

Estructura del proyecto

sentinal/
├── core/                     # Shared knowledge and scripts
│   ├── redis/
│   ├── docker/
│   └── kubernetes/
├── platforms/
│   ├── mcp/                  # MCP Server → npm
│   ├── openclaw/             # OpenClaw Skills → ClawHub
│   ├── chatgpt/              # Custom GPT → GPT Store
│   └── raycast/              # Extension → Raycast Store
└── scripts/                  # Build and publish automation

Desarrollo

Requisitos previos

Node.js 22+
pnpm 10+

Configuración

git clone https://github.com/Musaraf-M/sentinal.git
cd sentinal
pnpm install

Construcción

pnpm build

Ejecutar el servidor MCP localmente

node platforms/mcp/dist/index.js

Contribución

¡Las contribuciones son bienvenidas! Áreas donde se necesita ayuda:

Nuevos módulos de monitorización (Docker, Kubernetes, GitHub Actions)
Nuevos adaptadores de plataforma
Corrección de errores y mejoras

Licencia

MIT

Sentinal MCP