Skip to main content
Glama
mcp-redis-monitor

mcp-redis-monitor

by felhen-ai

mcp-redis-monitor

FastMCP server providing read-only tools to monitor Redis instances.

The server reads Redis metadata and queue state over stdio. It does not write, delete or dequeue data. For production use, configure a dedicated least-privilege Redis identity; username and TLS support are tracked in Issue #4.

Install

# Run directly with uvx (no install needed)
uvx mcp-redis-monitor

# Or install with pip
pip install mcp-redis-monitor

Related MCP server: Vigil

Environment Variables

Variable

Default

Description

REDIS_MONITOR_HOST

localhost

Redis host

REDIS_MONITOR_PORT

6379

Redis port

REDIS_MONITOR_PASSWORD

(none)

Redis password (optional)

Tools

Tool

Description

get_queue_depths

Keys + length by type in a specific DB (default: 3)

get_celery_queue_status

Celery queue names, pending count, oldest task

get_connected_clients

Number of connected clients

get_server_info

Memory, uptime, keyspace stats

get_key_count_by_db

Keys per database (overview)

Usage

mcp-redis-monitor

Or add to your MCP client configuration:

{
  "mcpServers": {
    "redis-monitor": {
      "command": "mcp-redis-monitor"
    }
  }
}

Development

ruff check src/ tests/
ruff format src/ tests/
pytest

License

MIT

Documentation and roadmap

Priorities live in GitHub Issues and Projects. Delivery history lives in closed Issues, pull requests and GitHub Releases.

Available Tools

5 tools
get_celery_queue_statusA

Get Celery queue names, pending task count, and oldest task age.

Scans DB 0 for Celery list-based queues (convention: keys without ':' prefix that are lists).

Returns: JSON with queue names, pending counts, and oldest task info.

Inputs: no named parameters. Returns: result

get_connected_clientsA

Get the number of currently connected Redis clients.

Returns: JSON with connected_clients count.

Inputs: no named parameters. Returns: result

get_key_count_by_dbA

Get the number of keys in each Redis database (overview).

Returns: JSON mapping database names to their key count.

Inputs: no named parameters. Returns: result

get_queue_depthsB

Get keys and their length by type in a specific Redis DB.

Args: db: Redis database number (default: 3).

Returns: JSON with key names, types, and sizes.

Inputs: db. Returns: result

get_server_infoA

Get Redis server info: memory usage, uptime, and keyspace stats.

Returns: JSON with memory, uptime, and keyspace data.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct monitoring aspect: Celery queues, connected clients, key counts by database, queue depths in a specific DB, and server info. No overlapping purposes.

    Naming Consistency5/5

    All tool names follow a consistent 'get_' prefix with descriptive snake_case nouns (e.g., get_celery_queue_status, get_connected_clients).

    Tool Count5/5

    Five tools is well-scoped for a Redis monitor, covering key monitoring areas without being too few or excessive.

    Completeness4/5

    Covers essential monitoring: server info, clients, key counts, and queue depths. Minor gaps like slowlog or replication are acceptable for a focused utility.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A lightweight npm MCP server for deep Redis diagnostics, offering tools for memory, slowlog, clients, keyspace, latency, and config analysis with AI-powered recommendations.
      8
      92 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCPWatch: observability for MCP servers. One line instruments any Python MCP server (FastMCP and the low-level Server) and tracks per-tool latency (p50/p95/p99), error rates, silent failures (empty/null returns and isError), and call volume. REST API, CLI, and alert hooks. MIT, no config required.
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Read-only Redis MCP server with a configurable command allowlist for safe production diagnostics, enabling exact read-only subcommands like CLIENT LIST and SLOWLOG GET.
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that lets an agent inspect and operate Redis-backed job queues, supporting Asynq and BullMQ backends with per-state counts, job details, and state transitions.
      6
      6 npm
      MIT