Skip to main content
Glama
yoojung2

incident-mcp

by yoojung2

incident-mcp

インシデント検知(detection) → 分析(analysis) を支援する Python MCP(Model Context Protocol) サーバーです。 メトリクス時系列から異常兆候を検知し、相関関係を束ねて 根本原因候補推奨アクション まで提示します。

1つのツール契約(tool contract)を2つのバックエンドが共有します:

サーバー

バックエンド

用途

mock-incident-mcp

組み込み合成データ (決定論的)

VMなしで開発・デモ・回帰テスト

vm-incident-mcp

実際の VictoriaMetrics HTTP API

運用/実測インシデント分析

2つのサーバーのツールシグネチャは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