observability-mcp
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 reportDie beiden Komponenten
Verzeichnis | Was es ist |
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 | |
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 Ihraz 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.
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Guarded MCP server for agent-readable business truth, provenance, readiness, and discovery.
MCP server for Appcircle mobile CI/CD platform.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP 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
- AlicenseNot gradedqualityBmaintenanceMCP server providing read-only operational tools (logs, metrics, traces, service health, config) for troubleshooting an environment, with one exception for toggling chaos scenarios.MIT
- AlicenseNot gradedqualityBmaintenanceMCP 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
- AlicenseNot gradedqualityBmaintenanceA 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