mcp-redis-monitor
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-monitorRelated MCP server: Vigil
Environment Variables
Variable | Default | Description |
|
| Redis host |
|
| Redis port |
| (none) | Redis password (optional) |
Tools
Tool | Description |
| Keys + length by type in a specific DB (default: 3) |
| Celery queue names, pending count, oldest task |
| Number of connected clients |
| Memory, uptime, keyspace stats |
| Keys per database (overview) |
Usage
mcp-redis-monitorOr add to your MCP client configuration:
{
"mcpServers": {
"redis-monitor": {
"command": "mcp-redis-monitor"
}
}
}Development
ruff check src/ tests/
ruff format src/ tests/
pytestLicense
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 toolsget_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
Scored across 5 tools
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.
All tool names follow a consistent 'get_' prefix with descriptive snake_case nouns (e.g., get_celery_queue_status, get_connected_clients).
Five tools is well-scoped for a Redis monitor, covering key monitoring areas without being too few or excessive.
Covers essential monitoring: server info, clients, key counts, and queue depths. Minor gaps like slowlog or replication are acceptable for a focused utility.
Maintenance
Related MCP Connectors
MCP server for the FFmpeg Micro video transcoding API — create, monitor, download transcodes.
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Related MCP Servers
- AlicenseAqualityDmaintenanceA lightweight npm MCP server for deep Redis diagnostics, offering tools for memory, slowlog, clients, keyspace, latency, and config analysis with AI-powered recommendations.892 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCPWatch: 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.1MIT
- AlicenseBqualityDmaintenanceRead-only Redis MCP server with a configurable command allowlist for safe production diagnostics, enabling exact read-only subcommands like CLIENT LIST and SLOWLOG GET.5MIT
- AlicenseAqualityCmaintenanceAn 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.66 npmMIT