MCP Redis Diagnostics

MCP Redis Diagnostics

Servidor MCP para diagnóstico de Redis — analise uso de memória, slowlog, conexões de clientes e saúde do keyspace com recomendações alimentadas por IA.

Por que esta ferramenta?

A maioria dos servidores MCP Redis são wrappers CRUD (get/set keys). O RedisNexus oferece diagnósticos, mas é voltado para empresas (K8s, SaaS multi-tenant). Esta ferramenta é o único pacote npm leve para diagnósticos profundos de Redis — 7 ferramentas cobrindo fragmentação de memória, padrões de slowlog, saúde de conexões de clientes, distribuição de keyspace, análise de latência e auditoria de configuração. Instale com npx, sem necessidade de Docker ou SaaS.

Nível Pro

Gere relatórios de diagnóstico exportáveis (HTML + PDF) com uma chave de licença Pro.

• Relatório completo de análise de thread dump JVM com recomendações acionáveis
• Exportação em PDF para compartilhar com sua equipe
• Suporte prioritário

$9.00/mês — Obter Licença Pro

A chave de licença Pro ativa a ferramenta MCP generate_report no mcp-jvm-diagnostics.

Ferramentas (7)

analyze_memory

Analise o uso de memória e a fragmentação do Redis.

Detecta:

• Alta fragmentação de memória (proporção RSS/usado >1,5x)
• Risco de swap (fragmentação <1,0)
• Pressão de maxmemory (aproximando-se do limite)
• Padrões de evicção
• Configuração de maxmemory ausente
• Política noeviction insegura

analyze_slowlog

Analise o SLOWLOG do Redis para comandos lentos.

Parâmetros:

• count (número, padrão: 128) — Número de entradas de slowlog a recuperar

Detecta:

• Comandos perigosos O(N): KEYS, SMEMBERS, HGETALL, SORT
• Comandos de alta latência (limiares >10ms, >100ms)
• Padrões de concentração de comandos
• Buffer de slowlog cheio (histórico ausente)

analyze_clients

Analise as conexões de clientes do Redis.

Detecta:

• Clientes bloqueados (BLPOP/BRPOP)
• Saturação do pool de conexões (>80% de maxclients)
• Conexões ociosas (>5 minutos)
• Grande memória de buffer de saída
• Padrões de assinantes Pub/sub

analyze_keyspace

Analise a distribuição do keyspace e a eficácia do cache do Redis.

Detecta:

• Baixa cobertura de TTL (<20% das chaves)
• Baixa taxa de acerto de cache (<80%)
• Distribuição desequilibrada de bancos de dados
• Altas taxas de expiração/evicção
• Anti-padrão de múltiplos bancos de dados

analyze_latency

Analise eventos de latência do Redis a partir do subsistema LATENCY.

Detecta:

• Picos de latência de fork (operações de salvamento em segundo plano RDB/AOF que bloqueiam)
• Atrasos de fsync do AOF e latência de escrita
• Processamento lento de comandos (comandos O(1) inesperadamente lentos)
• Atrasos no ciclo de evicção e expiração de chaves
• Impacto da desfragmentação ativa
• Tendências crescentes de latência ao longo do tempo

Requer que latency-monitor-threshold seja definido no redis.conf (por exemplo, CONFIG SET latency-monitor-threshold 100).

analyze_config

Analise a configuração do Redis para riscos de segurança e confiabilidade.

Detecta:

• Sem limite de maxmemory (crescimento ilimitado de memória, risco de OOM)
• Política de evicção insegura (noeviction causando erros no limite de memória)
• Exposição de rede (bind 0.0.0.0 sem protected-mode)
• Autenticação ausente (sem requirepass)
• Persistência desabilitada (AOF e RDB desligados — perda de dados ao reiniciar)
• Acúmulo de conexões ociosas (timeout 0)
• TCP keepalive desabilitado (conexões mortas não detectadas)
• Baixa frequência do servidor (hz < 10 atrasando tarefas em segundo plano)

analyze_performance

Avaliação abrangente de saúde — executa todos os analisadores e produz um relatório unificado.

Parâmetros:

• slowlog_count (número, padrão: 128) — Número de entradas de slowlog

Instalação

npm install -g mcp-redis-diagnostics

Ou execute diretamente:

npx mcp-redis-diagnostics

Configuração

Variáveis de Ambiente

Variável	Descrição	Padrão
REDIS_URL	String de conexão Redis	redis://localhost:6379

Claude Desktop

Adicione a claude_desktop_config.json:

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

Redis com senha:

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

Demonstração Rápida

Depois de configurado, experimente estes prompts no Claude:

1. "Analise meu uso de memória do Redis — há fragmentação?" — Mostra memória usada vs. máxima, proporção de fragmentação, política de evicção e problemas de pressão de memória
2. "Verifique o slowlog do Redis para comandos perigosos" — Identifica comandos O(N) como KEYS/SMEMBERS, padrões de alta latência e sugestões de otimização
3. "Execute uma verificação completa de saúde do Redis" — Relatório unificado combinando memória, slowlog, clientes, keyspace e análise de latência

"Qual é minha taxa de acerto de cache? Meus TTLs estão configurados corretamente?"

"Faça uma verificação completa de saúde do Redis"

Parte do Conjunto de Backend Java MCP

Esta ferramenta faz parte de um conjunto de servidores MCP para desenvolvedores de backend:

• mcp-db-analyzer — Análise de esquema PostgreSQL/MySQL/SQLite
• mcp-jvm-diagnostics — Análise de thread dump e logs de GC
• mcp-migration-advisor — Análise de risco de migração Flyway/Liquibase
• mcp-spring-boot-actuator — Análise de saúde e métricas do Spring Boot
• mcp-redis-diagnostics — Diagnósticos de memória, slowlog e clientes do Redis

Limitações e Problemas Conhecidos

• Instância única de Redis: Analisa uma instância de Redis por vez. Não suporta descoberta de topologia do Redis Cluster nem análise de failover do Sentinel.
• Restrições de ACL: Algumas ferramentas exigem comandos Redis específicos (SLOWLOG, CLIENT LIST, LATENCY). As ACLs do Redis podem bloquear esses comandos. A ferramenta unificada analyze_performance lida com falhas parciais de forma graciosa.
• Monitoramento de latência: A ferramenta analyze_latency requer que latency-monitor-threshold seja definido no redis.conf. Sem isso, nenhum evento de latência é capturado.
• Análise em nível de chave: A análise de keyspace usa agregados de INFO keyspace. A inspeção individual de chaves (por exemplo, encontrar as maiores chaves) requer MEMORY USAGE por chave, o que não é realizado para evitar impacto na produção.
• Redis Cluster: Sem análise específica de cluster (distribuição de slots, rebalanceamento, latência entre nós). Funciona apenas contra nós individuais.
• Módulos Redis: Comandos e tipos de dados específicos de módulos (RedisJSON, RediSearch, RedisTimeSeries) não são analisados.
• Conselheiro de memória: As recomendações de memória são baseadas em estatísticas de INFO memory. Para um detalhamento de memória por tipo de chave, use redis-cli --bigkeys externamente.
• Proporção de fragmentação: A fragmentação de memória usa a proporção RSS vs. memória usada, que pode ser distorcida pelo jemalloc. Valores <1,0 podem nem sempre indicar swap.
• Somente leitura: Todos os comandos são somente leitura (INFO, SLOWLOG GET, CLIENT LIST, LATENCY). Nenhum dado ou configuração é modificado.

Licença

MIT

---

Fim de vida: 2026-05-10.

Este servidor MCP não é mais mantido ou distribuído. A Corporation mudou para atores do marketplace Apify. Veja irrationalways no Apify e irrcorp/bzp-poland-tenders para o trabalho atual da Corporation.

O pacote npm foi despublicado. O repositório está arquivado apenas para referência histórica.