io.github.Musaraf-M/sentinal-mcp
Redis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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>"
}
}
}
}
متغيرات البيئة
REDIS_URLسري Redis connection URL
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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
الأسئلة الشائعة
ما هو io.github.Musaraf-M/sentinal-mcp؟
Redis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics
كيف أثبّت io.github.Musaraf-M/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 من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.Musaraf-M/sentinal-mcp إلى مفتاح API؟
نعم. يتطلب REDIS_URL، وتضبطها في إعداداته.
هل io.github.Musaraf-M/sentinal-mcp مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.Musaraf-M/sentinal-mcp؟
ينشره Musaraf-M. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.