mcp-incident-analyzer

Python 기반 MCP(Model Context Protocol) 서버로, 인시던트 탐지 → 분석 → 대응 가이드까지 풀 사이클을 지원합니다.

기능

Tool	설명
`detect_incidents`	현재 활성 인시던트 탐지 (심각도/유형별 필터링)
`analyze_incident`	특정 인시던트의 근본 원인 분석 (RCA), 타임라인, 영향 범위
`suggest_response`	인시던트 대응 권고 (자동/수동 조치, 에스컬레이션)
`list_incidents`	전체 인시던트 목록 조회
`get_metrics`	시스템 메트릭 조회 (CPU, 메모리, 네트워크 등)

인시던트 유형

인프라: 서버 다운, CPU 스파이크, 디스크 풀
보안: 비정상 로그인, 악성 트래픽, 침입 탐지
애플리케이션: 에러율 급증, 응답 지연, 배포 실패

설치 & 실행

# 설치
pip install -e .

# MCP 서버 실행
python -m mcp_incident_analyzer

# 또는 mcp CLI로 실행
mcp run mcp_incident_analyzer/server.py

MCP 클라이언트 설정

claude_desktop_config.json 또는 MCP 클라이언트 설정에 추가:

{
  "mcpServers": {
    "incident-analyzer": {
      "command": "python",
      "args": ["-m", "mcp_incident_analyzer"]
    }
  }
}

개발

pip install -e ".[dev]"
pytest

아키텍처

mcp_incident_analyzer/
├── __init__.py
├── __main__.py          # 엔트리포인트
├── server.py            # MCP 서버 정의 & tool 등록
├── models.py            # Pydantic 데이터 모델
├── mock_data.py         # Mock 인시던트/메트릭 데이터
├── detector.py          # 인시던트 탐지 로직
├── analyzer.py          # 근본 원인 분석 로직
└── responder.py         # 대응 권고 생성 로직

라이선스

MIT