Sentinal Mcp

Sentinal

面向 AI 助手的基础设施监控工具。一套代码库，支持多个平台。

通过自然对话，让 AI 助手检查 Redis 健康状况、检查 BullMQ 队列、诊断慢查询。

平台

平台	分发方式	安装
Claude、Cursor、Copilot、Cline、Warp、Gemini CLI	MCP 服务（npm）	npx @md-musaraf/sentinal-mcp
OpenClaw	ClawHub	clawhub install sentinal-redis
ChatGPT	GPT Store	即将推出
Raycast	Raycast Store	即将推出

模块

模块	状态	监控内容
Redis	✅ 已就绪	服务健康状况、内存、慢查询、客户端、BullMQ 队列
Docker	🔜 计划中	容器健康状况、日志、资源使用情况
Kubernetes	🔜 计划中	Pod 状态、重启次数、资源限制
GitHub Actions	🔜 计划中	工作流运行、失败、重新触发
Vercel	🔜 计划中	部署状态、回滚

MCP 服务

适用于所有支持 Model Context Protocol 的 AI 工具，包括 Claude Desktop、Claude Code、Cursor、GitHub Copilot、Cline、Warp、Gemini CLI、Continue 等。

安装

将以下内容添加到 MCP 客户端配置中：

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

工具

工具	描述
redis_ping	测试与 Redis 实例的连接
redis_health	完整的健康报告——服务、内存、客户端、慢查询、BullMQ 队列
redis_memory	深入分析内存，并诊断内存碎片
redis_slowlog	检查慢查询
bullmq_list	列出所有 BullMQ 队列及各状态下的作业数
bullmq_failed_jobs	检查失败作业及其负载和堆栈跟踪
bullmq_job_details	查看特定作业的完整详细信息
bullmq_stale_jobs	查找卡在 active 状态的作业

使用示例

只需向 AI 助手提问：

• “检查我的 Redis 健康状况”
• “有没有 BullMQ 队列积压？”
• “显示 email-queue 中的失败作业”
• “Redis 为什么这么慢？”
• “Redis 使用了多少内存？”
• “查找 payment-queue 中的过期作业”

OpenClaw 技能

从 ClawHub 安装单项技能：

clawhub install sentinal-redis

该技能可教会 OpenClaw 助手使用 redis-cli 监控 Redis 和 BullMQ。无需编写代码——安装后直接提问即可。

项目结构

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

开发

前提条件

• Node.js 22+
• pnpm 10+

设置

git clone https://github.com/Musaraf-M/sentinal.git
cd sentinal
pnpm install

构建

pnpm build

在本地运行 MCP 服务

node platforms/mcp/dist/index.js

贡献

欢迎贡献！以下方面需要帮助：

• 新的监控模块（Docker、Kubernetes、GitHub Actions）
• 新的平台适配器
• 错误修复和改进

许可证

MIT