MCP Redis Diagnostics

MCP Redis Diagnostics

Servidor MCP para diagnósticos de Redis: analiza uso de memoria, slowlog, conexiones de clientes y salud del keyspace con recomendaciones impulsadas por IA.

¿Por qué esta herramienta?

La mayoría de los servidores MCP de Redis son envoltorios CRUD (get/set de claves). RedisNexus ofrece diagnósticos pero está orientado a empresas (K8s, SaaS multiinquilino). Esta herramienta es el único paquete npm ligero para diagnósticos profundos de Redis: 7 herramientas que cubren fragmentación de memoria, patrones de slowlog, salud de conexiones de clientes, distribución del keyspace, análisis de latencia y auditoría de configuración. Instala con npx, sin necesidad de Docker ni SaaS.

Nivel Pro

Genera informes de diagnóstico exportables (HTML + PDF) con una clave de licencia Pro.

• Informe completo de análisis de volcado de hilos JVM con recomendaciones accionables
• Exportación a PDF para compartir con tu equipo
• Soporte prioritario

$9.00/mes — Obtén la licencia Pro

La clave de licencia Pro activa la herramienta MCP generate_report en mcp-jvm-diagnostics.

Herramientas (7)

analyze_memory

Analiza el uso de memoria de Redis y la fragmentación.

Detecta:

• Fragmentación alta de memoria (proporción RSS/usado >1.5x)
• Riesgo de swap (fragmentación <1.0)
• Presión de maxmemory (acercándose al límite)
• Patrones de desalojo
• Configuración de maxmemory ausente
• Política noeviction insegura

analyze_slowlog

Analiza el SLOWLOG de Redis para comandos lentos.

Parámetros:

• count (número, predeterminado: 128) — Cantidad de entradas de slowlog a recuperar

Detecta:

• Comandos O(N) peligrosos: KEYS, SMEMBERS, HGETALL, SORT
• Comandos de alta latencia (umbrales >10ms, >100ms)
• Patrones de concentración de comandos
• Buffer de slowlog completo (historial faltante)

analyze_clients

Analiza las conexiones de clientes de Redis.

Detecta:

• Clientes bloqueados (BLPOP/BRPOP)
• Saturación del pool de conexiones (>80% de maxclients)
• Conexiones inactivas (>5 minutos)
• Memoria grande de buffer de salida
• Patrones de suscriptores pub/sub

analyze_keyspace

Analiza la distribución del keyspace de Redis y la efectividad de la caché.

Detecta:

• Cobertura TTL baja (<20% de las claves)
• Tasa de aciertos de caché baja (<80%)
• Distribución desequilibrada de bases de datos
• Tasas altas de expiración/desalojo
• Antipatrón de múltiples bases de datos

analyze_latency

Analiza eventos de latencia de Redis desde el subsistema LATENCY.

Detecta:

• Picos de latencia por fork (operaciones de guardado en segundo plano RDB/AOF que bloquean)
• Retrasos de fsync de AOF y latencia de escritura
• Procesamiento lento de comandos (comandos O(1) inesperadamente lentos)
• Ciclos de desalojo y expiración de claves con retrasos
• Impacto de la desfragmentación activa
• Tendencias crecientes de latencia con el tiempo

Requiere que latency-monitor-threshold esté configurado en redis.conf (por ejemplo, CONFIG SET latency-monitor-threshold 100).

analyze_config

Analiza la configuración de Redis para riesgos de seguridad y confiabilidad.

Detecta:

• Sin límite de maxmemory (crecimiento de memoria sin límite, riesgo de OOM)
• Política de desalojo insegura (noeviction que causa errores en el límite de memoria)
• Exposición de red (bind 0.0.0.0 sin protected-mode)
• Autenticación ausente (sin requirepass)
• Persistencia deshabilitada (AOF y RDB apagados: pérdida de datos al reiniciar)
• Acumulación de conexiones inactivas (timeout 0)
• TCP keepalive deshabilitado (conexiones muertas no detectadas)
• Frecuencia de servidor baja (hz < 10 que ralentiza tareas en segundo plano)

analyze_performance

Evaluación integral de salud: ejecuta todos los analizadores y produce un informe unificado.

Parámetros:

• slowlog_count (número, predeterminado: 128) — Cantidad de entradas de slowlog

Instalación

npm install -g mcp-redis-diagnostics

O ejecuta directamente:

npx mcp-redis-diagnostics

Configuración

Variables de entorno

Variable	Descripción	Predeterminado
REDIS_URL	Cadena de conexión de Redis	redis://localhost:6379

Claude Desktop

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "redis-diagnostics": {
      "command": "npx",
      "args": ["-y", "mcp-redis-diagnostics"],
      "env": {
        "REDIS_URL": "redis://localhost:6379"
      }
    }
  }
}

Redis con contraseña:

{
  "env": {
    "REDIS_URL": "redis://:yourpassword@localhost:6379"
  }
}

Demo rápida

Una vez configurado, prueba estos mensajes en Claude:

1. "Analiza mi uso de memoria de Redis: ¿hay fragmentación?" — Muestra memoria usada vs. máxima, proporción de fragmentación, política de desalojo y problemas de presión de memoria
2. "Revisa el slowlog de Redis en busca de comandos peligrosos" — Identifica comandos O(N) como KEYS/SMEMBERS, patrones de alta latencia y sugerencias de optimización
3. "Ejecuta una verificación de salud completa de Redis" — Informe unificado que combina análisis de memoria, slowlog, clientes, keyspace y latencia

"¿Cuál es mi tasa de aciertos de caché? ¿Están mis TTL configurados correctamente?"

"Dame una verificación de salud completa de Redis"

Parte del conjunto MCP Java Backend

Esta herramienta es parte de un conjunto de servidores MCP para desarrolladores backend:

• mcp-db-analyzer — Análisis de esquemas PostgreSQL/MySQL/SQLite
• mcp-jvm-diagnostics — Análisis de volcados de hilos y registros GC
• mcp-migration-advisor — Análisis de riesgo de migraciones Flyway/Liquibase
• mcp-spring-boot-actuator — Análisis de salud y métricas de Spring Boot
• mcp-redis-diagnostics — Diagnósticos de memoria, slowlog y clientes de Redis

Limitaciones y problemas conocidos

• Instancia única de Redis: Analiza una instancia de Redis a la vez. No admite descubrimiento de topología de Redis Cluster ni análisis de conmutación por error de Sentinel.
• Restricciones de ACL: Algunas herramientas requieren comandos específicos de Redis (SLOWLOG, CLIENT LIST, LATENCY). Las ACL de Redis pueden bloquearlos. La herramienta unificada analyze_performance maneja fallos parciales con elegancia.
• Monitoreo de latencia: La herramienta analyze_latency requiere que latency-monitor-threshold esté configurado en redis.conf. Sin esto, no se capturan eventos de latencia.
• Análisis a nivel de claves: El análisis del keyspace usa agregados de INFO keyspace. La inspección de claves individuales (por ejemplo, encontrar las claves más grandes) requiere MEMORY USAGE por clave, lo cual no se realiza para evitar impactar la producción.
• Redis Cluster: Sin análisis específico de clúster (distribución de slots, rebalanceo, latencia entre nodos). Funciona solo contra nodos individuales.
• Módulos de Redis: Los comandos y tipos de datos específicos de módulos (RedisJSON, RediSearch, RedisTimeSeries) no se analizan.
• Asesor de memoria: Las recomendaciones de memoria se basan en estadísticas de INFO memory. Para un desglose detallado de memoria por tipo de clave, usa redis-cli --bigkeys externamente.
• Proporción de fragmentación: La fragmentación de memoria usa la proporción RSS vs. memoria usada, que puede distorsionarse por jemalloc. Valores <1.0 pueden no indicar siempre swapping.
• Solo lectura: Todos los comandos son de solo lectura (INFO, SLOWLOG GET, CLIENT LIST, LATENCY). No se modifican datos ni configuración.

Licencia

MIT

---

Fin de vida útil: 2026-05-10.

Este servidor MCP ya no se mantiene ni se distribuye. La Corporación ha cambiado a actores del marketplace de Apify. Consulta irrationalways en Apify y irrcorp/bzp-poland-tenders para el trabajo actual de la Corporación.

El paquete npm ha sido despublicado. El repositorio está archivado con fines de referencia histórica únicamente.