Skip to main content
Glama
yoojung2

incident-mcp

by yoojung2

incident-mcp

**인시던트 발견(detection) → 분석(analysis)**을 돕는 Python MCP(Model Context Protocol) 서버입니다. 메트릭 시계열에서 이상 징후를 탐지하고, 상관 관계를 묶어 근본원인 후보권장 조치까지 제시합니다.

하나의 도구 계약(tool contract)을 두 개의 백엔드가 공유합니다:

서버

백엔드

용도

mock-incident-mcp

내장 합성 데이터 (결정론)

VM 없이 개발·데모·회귀테스트

vm-incident-mcp

실제 VictoriaMetrics HTTP API

운영/실측 인시던트 분석

두 서버의 도구 시그니처가 100% 동일하므로, mock으로 워크플로를 개발한 뒤 무중단으로 실제 VM 전환이 됩니다.


아키텍처

incident_mcp/
├── core/                    # 백엔드 무관 공통 로직 (순수 함수 → 테스트 용이)
│   ├── models.py            # Pydantic: Anomaly, IncidentAnalysis, Series ...
│   ├── datasource.py        # Protocol(인터페이스) — VM/Mock이 구현
│   ├── detection.py         # 이상탐지: zscore · spike · trend · threshold
│   └── analysis.py          # 상관분석 + 근본원인 휴리스틱
├── datasources/
│   ├── mock_ds.py           # 재현 가능한 합성 메트릭 + 주입된 인시던트 시나리오
│   └── vm_ds.py             # VictoriaMetrics(Prometheus 호환) HTTP 클라이언트
├── servers/
│   ├── mock_server.py       # B: mock 데이터소스 주입
│   └── vm_server.py         # A: VictoriaMetrics 데이터소스 주입
└── tools.py                 # 공통 MCP 도구 4종 (두 서버가 공유)

MCP 도구 4종

도구

설명

list_metrics

사용 가능한 메트릭 카탈로그

fetch_series

원시 시계열 조회 (확인/디버깅)

detect_anomalies

이상탐지 실행 (zscore/spike/trend)

analyze_incident

탐지→분석 원스텝 (근본원인 후보 + 권장조치)


Related MCP server: MCP Server for vmanomaly

빠른 시작

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# 단위 테스트
pytest -q

# mock 서버로 종단(E2E) 데모 — mock 2개 시나리오 + 실제 VM
python examples/e2e_client.py

문서 (단계별)


이상탐지 방법 (요약)

방법

잡는 패턴

예시 인시던트

zscore

평균에서 크게 벗어난 순간값

순간 스파이크

spike

직전 구간 대비 급격한 변화율

에러율 급증

trend

완만한 단조 증가/감소

메모리 누수 (zscore/spike로는 안 잡힘)

threshold

절대 임계치 위반

SLA 한계 초과

💡 메모리 누수처럼 "서서히 새는" 패턴은 순간값 기반(zscore/spike)으로는 탐지되지 않아 회귀 기울기 기반 trend 탐지기를 별도로 두었습니다. — step2 참고

라이선스

MIT

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    A comprehensive, AI-powered performance analysis and monitoring platform for OpenShift/Kubernetes clusters. This project provides Model Context Protocol (MCP) servers for analyzing etcd, network, and OVN-Kubernetes components with deep performance insights, automated root cause analysis, and actionable recommendations.
    1
    Apache 2.0
  • F
    license
    A
    quality
    C
    maintenance
    AI-powered incident management MCP server that enables investigation, root cause analysis, and response actions for production incidents using mocked data for demo purposes.
    8

View all related MCP servers

Related MCP Connectors

  • Monitor MCP servers, API contracts and AI outputs for schema drift. Alerts on breaking changes.

  • Free MCP tools: the only MCP linter, health checks, cost estimation, and trust evaluation.

  • Hosted MCP endpoint with realistic fake data for prototyping agents. 12 tools, no setup.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yoojung2/incident-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server