@md-musaraf/sentinal-mcp

@md-musaraf/sentinal-mcp

MCP server for infrastructure monitoring. Works with Claude, Cursor, GitHub Copilot, Cline, Warp, Gemini CLI, and any MCP-compatible AI assistant.

Monitor Redis health, BullMQ queues, memory, and slow queries — all through natural conversation with your AI assistant.

Install

Add to your MCP client config:

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

Claude Desktop

Add the above to ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

claude mcp add sentinal npx @md-musaraf/sentinal-mcp

Cursor

Add the above to .cursor/mcp.json in your project root.

GitHub Copilot

Add the above to .github/copilot/mcp.json in your repository.

Tools

Redis Server

Tool	Description
redis_ping	Test connectivity to a Redis instance
redis_health	Full health report — server, memory, clients, slow queries, BullMQ queues
redis_memory	Deep memory analysis with fragmentation diagnostics
redis_slowlog	Inspect slow queries

BullMQ Queues

Tool	Description
bullmq_list	List all BullMQ queues with job counts per state
bullmq_failed_jobs	Inspect failed jobs with payloads and stack traces
bullmq_job_details	Full details of a specific job
bullmq_stale_jobs	Find jobs stuck in active state

Example Usage

Just ask your AI assistant:

• "Check my Redis health"
• "Are any BullMQ queues backing up?"
• "Show me failed jobs in the email-queue"
• "Why is Redis slow?"
• "How much memory is Redis using?"
• "Find stale jobs in the payment-queue"

Configuration

Environment Variable	Default	Description
REDIS_URL	redis://localhost:6379	Redis connection URL

Each tool also accepts a redis_url parameter to override the default per-call.

Upcoming Modules

• Docker — container health, logs, resource usage
• Kubernetes — pod status, restart counts, resource limits
• GitHub Actions — workflow runs, failures, re-triggers

Links

• GitHub
• Report Issues

License

MIT