Sentinal

npm Glama License: MIT

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