English Français العربية

io.github.Musaraf-M/sentinal-mcp

Official registry Data and databases

Redis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @md-musaraf/sentinal-mcp
Claude Code 
claude mcp add sentinal-mcp -e 'REDIS_URL=<your redis_url>' -- npx -y @md-musaraf/sentinal-mcp@1.0.5
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sentinal-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@md-musaraf/sentinal-mcp@1.0.5"
            ],
            "env": {
                "REDIS_URL": "<your redis_url>"
            }
        }
    }
}

Environment variables

  • REDIS_URL secret Redis connection URL

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Sentinal
  2. Platforms
  3. Modules
  4. MCP Server
  5. OpenClaw Skills
  6. Project Structure
  7. Development
  8. Contributing
  9. License

Sentinal

Infrastructure monitoring tools for AI assistants. One codebase, multiple platforms.

Ask your AI assistant to check Redis health, inspect BullMQ queues, diagnose slow queries — all through natural conversation.

Platforms

PlatformDistributionInstall
Claude, Cursor, Copilot, Cline, Warp, Gemini CLIMCP Server (npm)npx @md-musaraf/sentinal-mcp
OpenClawClawHubclawhub install sentinal-redis
ChatGPTGPT StoreComing soon
RaycastRaycast StoreComing soon

Modules

ModuleStatusWhat it monitors
Redis✅ ReadyServer health, memory, slow queries, clients, BullMQ queues
Docker🔜 PlannedContainer health, logs, resource usage
Kubernetes🔜 PlannedPod status, restart counts, resource limits
GitHub Actions🔜 PlannedWorkflow runs, failures, re-triggers
Vercel🔜 PlannedDeployment status, rollbacks

MCP Server

Works with any AI tool that supports Model Context Protocol — Claude Desktop, Claude Code, Cursor, GitHub Copilot, Cline, Warp, Gemini CLI, Continue, and more.

Install

Add to your MCP client config:

{
  "mcpServers": {
    "sentinal": {
      "command": "npx",
      "args": ["@md-musaraf/sentinal-mcp"],
      "env": {
        "REDIS_URL": "redis://localhost:6379"
      }
    }
  }
}
Tools
ToolDescription
redis_pingTest connectivity to a Redis instance
redis_healthFull health report — server, memory, clients, slow queries, BullMQ queues
redis_memoryDeep memory analysis with fragmentation diagnostics
redis_slowlogInspect slow queries
bullmq_listList all BullMQ queues with job counts per state
bullmq_failed_jobsInspect failed jobs with payloads and stack traces
bullmq_job_detailsFull details of a specific job
bullmq_stale_jobsFind 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"

OpenClaw Skills

Install individual skills from ClawHub:

clawhub install sentinal-redis

The skill teaches your OpenClaw assistant to monitor Redis and BullMQ using redis-cli. No code required — just install and ask.

Project Structure

sentinal/
├── core/                     # Shared knowledge and scripts
│   ├── redis/
│   ├── docker/
│   └── kubernetes/
├── platforms/
│   ├── mcp/                  # MCP Server → npm
│   ├── openclaw/             # OpenClaw Skills → ClawHub
│   ├── chatgpt/              # Custom GPT → GPT Store
│   └── raycast/              # Extension → Raycast Store
└── scripts/                  # Build and publish automation

Development

Prerequisites
  • Node.js 22+
  • pnpm 10+
Setup
git clone https://github.com/Musaraf-M/sentinal.git
cd sentinal
pnpm install
Build
pnpm build
Run MCP server locally
node platforms/mcp/dist/index.js

Contributing

Contributions are welcome! Areas where help is needed:

  • New monitoring modules (Docker, Kubernetes, GitHub Actions)
  • New platform adapters
  • Bug fixes and improvements

License

MIT

Frequently asked questions

What is io.github.Musaraf-M/sentinal-mcp?

Redis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics

How do I install io.github.Musaraf-M/sentinal-mcp?

It runs on your machine. In Claude Code: claude mcp add sentinal-mcp -e 'REDIS_URL=<your redis_url>' -- npx -y @md-musaraf/sentinal-mcp@1.0.5. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Musaraf-M/sentinal-mcp need an API key?

Yes. It expects REDIS_URL, which you set in its configuration.

Is io.github.Musaraf-M/sentinal-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Musaraf-M/sentinal-mcp?

It is published by Musaraf-M. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.