Skip to main content
Glama
dev-hops

observability-mcp

by dev-hops

Azure Incident Investigation

Ein zweiteiliges Portfolio-Projekt: ein schreibgeschützter MCP-Server, der Azure-Beobachtungswerkzeuge bereitstellt, und ein autonomer Agent, der diese Werkzeuge zur Untersuchung von Vorfällen antreibt und einen synthetisierten Ursachenbericht erstellt. Eine kostenlose, selbst erstellte, minimalistische Interpretation der Idee hinter Microsofts Azure SRE Agent – und, wie der „Reader-Modus“ dieses Tools, durchgängig schreibgeschützt.

 you ──"symptom"──▶  incident-agent  ──MCP (stdio/HTTP)──▶  observability-mcp  ──▶  Azure
                     (Claude Agent SDK)                     (9 read-only tools)     (App Insights,
                          │                                                          App Service,
                          └── streams its reasoning + tool calls live,               Activity Log)
                              then emits a Markdown root-cause report

Die beiden Komponenten

Verzeichnis

Was es ist

observability-mcp/

Die Werkzeugschicht. Ein Model Context Protocol-Server (TypeScript, stdio oder Streamable HTTP), der 9 schreibgeschützte Werkzeuge über Application Insights-Telemetrie, App Service-Bereitstellungsverlauf, App Service-Plan-Metriken und das Azure Activity Log bereitstellt – alle korreliert über operation_Id. Authentifizierung über DefaultAzureCredential (keine Geheimnisse im Code).

incident-agent/

Der Ermittler. Ein eigenständiger Agent (Claude Agent SDK), der sich mit dem MCP-Server als Client verbindet und dessen Werkzeuge autonom antreibt – beginnend eng, das Zeitfenster erweiternd, den Beginn lokalisierend, identifizierend, was sich geändert hat, und bestätigend anhand einer Ablaufverfolgung – bevor er einen evidenzgestützten Bericht erstellt. Von Grund auf schreibgeschützt.

Jedes Verzeichnis ist ein eigenständiges npm-Projekt mit eigener README, die Einrichtung, Konfiguration und Ausführung beschreibt. Beginnen Sie mit observability-mcp/ (den Werkzeugen), dann incident-agent/ (dem Agenten, der sie antreibt).

Related MCP server: ops-agent-toolkit-mcp

Entwurfsprinzipien

  • Immer schreibgeschützt. Jedes Werkzeug ruft nur list* / get* / Query-APIs auf; der Agent leitet jeden Werkzeugaufruf durch ein einziges standardmäßig verweigerndes Gate. Nichts in diesem Projekt kann etwas ändern, neu starten, skalieren oder löschen.

  • Keine Geheimnisse in Code oder Konfiguration. Der Azure-Zugriff erfolgt über DefaultAzureCredential (lokal Ihr az login; bei Bereitstellung eine verwaltete Identität). Siehe die README jeder Komponente für das Authentifizierungs- und Sicherheitsmodell.

  • Lokal oder gehostet ausführbar. Der MCP-Server spricht stdio für die lokale Nutzung und Streamable HTTP für das Hosting (z. B. Azure Container Apps); der Agent verbindet sich mit beiden.

Dies ist ein Labor-/Portfolio-Projekt – sicher zum Ausführen und Lesen, aber bewusst nicht für die Produktion gehärtet. Siehe die Hinweise zum „Sicherheitsmodell“ jeder Komponente, bevor Sie es an einem erreichbaren Ort bereitstellen.

Lizenz

MIT.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for investigating cloud incidents and managing approvals. Provides read-only tools to list incidents, investigate incidents, and list approvals, keeping remediation behind human approval.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server providing read-only operational tools (logs, metrics, traces, service health, config) for troubleshooting an environment, with one exception for toggling chaos scenarios.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server that provides guarded, audited, read-only access to ops tooling (alerts, metrics, logs, deploys, runbooks) and a triage agent that diagnoses incidents end-to-end with CI-verified root cause analysis.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    A read-only MCP server that exposes Kubernetes cluster telemetry tools (pods, events, logs, metrics, ArgoCD syncs) with automatic redaction for incident triage and hypothesis ranking.
    MIT