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

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: aws-safe-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.