# mcp-incident-analyzer

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

## 기능

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

## 인시던트 유형

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

## 설치 & 실행

```bash
# 설치
pip install -e .

# MCP 서버 실행
python -m mcp_incident_analyzer

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

## MCP 클라이언트 설정

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

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

## 개발

```bash
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