Skip to main content
Glama
yoojung2

incident-mcp

by yoojung2

incident-mcp

A Python MCP (Model Context Protocol) server that helps with incident detection → analysis. It detects anomalies in metric time series, groups correlations, and presents root cause candidates and recommended actions.

Two backends share a single tool contract:

Server

Backend

Purpose

mock-incident-mcp

Built-in synthetic data (deterministic)

Development, demo, and regression testing without VM

vm-incident-mcp

Real VictoriaMetrics HTTP API

Production/real-measurement incident analysis

Since the two servers' tool signatures are 100% identical, you can develop a workflow with the mock and then switch to the real VM without interruption.


Architecture

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종 (두 서버가 공유)

4 MCP tools

Tool

Description

list_metrics

Available metric catalog

fetch_series

Raw time series query (verification/debugging)

detect_anomalies

Run anomaly detection (zscore/spike/trend)

analyze_incident

One-step detection→analysis (root cause candidates + recommended actions)


Related MCP server: MCP Server for vmanomaly

Quick Start

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

# 단위 테스트
pytest -q

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

Documentation (step-by-step)


Anomaly detection methods (summary)

Method

Pattern caught

Example incident

zscore

Instantaneous value far from the mean

Momentary spike

spike

Rapid rate of change compared to the previous interval

Error rate surge

trend

Gradual monotonic increase/decrease

Memory leak (not caught by zscore/spike)

threshold

Absolute threshold violation

SLA limit exceeded

💡 Patterns that "leak slowly," like memory leaks, are not detected by instantaneous-value-based (zscore/spike) methods, so we added a separate regression-slope-based trend detector. — See step2

License

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