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	🔜 계획됨	파드 상태, 재시작 횟수, 리소스 제한
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`	활성 상태에서 멈춘 작업 찾기

사용 예시

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

Sentinal MCP