io.github.Musaraf-M/sentinal-mcp
Redis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
@md-musaraf/sentinal-mcpclaude mcp add sentinal-mcp -e 'REDIS_URL=<your redis_url>' -- npx -y @md-musaraf/sentinal-mcp@1.0.5
{
"mcpServers": {
"sentinal-mcp": {
"command": "npx",
"args": [
"-y",
"@md-musaraf/sentinal-mcp@1.0.5"
],
"env": {
"REDIS_URL": "<your redis_url>"
}
}
}
}
Variables d'environnement
REDIS_URLsecret Redis connection URL
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
| Platform | Distribution | Install |
|---|---|---|
| Claude, Cursor, Copilot, Cline, Warp, Gemini CLI | MCP Server (npm) | npx @md-musaraf/sentinal-mcp |
| OpenClaw | ClawHub | clawhub install sentinal-redis |
| ChatGPT | GPT Store | Coming soon |
| Raycast | Raycast Store | Coming soon |
Modules
| Module | Status | What it monitors |
|---|---|---|
| Redis | ✅ Ready | Server health, memory, slow queries, clients, BullMQ queues |
| Docker | 🔜 Planned | Container health, logs, resource usage |
| Kubernetes | 🔜 Planned | Pod status, restart counts, resource limits |
| GitHub Actions | 🔜 Planned | Workflow runs, failures, re-triggers |
| Vercel | 🔜 Planned | Deployment 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
| 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_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"
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
Questions fréquentes
Qu'est-ce que io.github.Musaraf-M/sentinal-mcp ?
Redis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics
Comment installer io.github.Musaraf-M/sentinal-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add sentinal-mcp -e 'REDIS_URL=<your redis_url>' -- npx -y @md-musaraf/sentinal-mcp@1.0.5. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.Musaraf-M/sentinal-mcp ?
Oui. Il attend REDIS_URL, à renseigner dans sa configuration.
io.github.Musaraf-M/sentinal-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.Musaraf-M/sentinal-mcp ?
Il est publié par Musaraf-M. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.