Azure Incident Investigation

Un proyecto de portafolio en dos partes: un servidor MCP de solo lectura que expone herramientas de observabilidad de Azure, y un agente autónomo que maneja esas herramientas para investigar incidentes y producir un informe de causa raíz sintetizado. Una versión gratuita, de elaboración propia y mínima de la idea detrás del Azure SRE Agent de Microsoft — y, como el "modo de lectura" de esa herramienta, estrictamente de solo lectura en todo momento.

 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

Los dos componentes

Cada directorio es un proyecto npm independiente con su propio README que cubre la instalación, la configuración y cómo ejecutarlo. Empieza con observability-mcp/ (las herramientas) y luego con incident-agent/ (el agente que las maneja).

Related MCP server: aws-safe-mcp

Principios de diseño

• Solo lectura, siempre. Cada herramienta llama únicamente a APIs list* / get* / de consulta; el agente enruta cada llamada de herramienta a través de una única puerta de denegación por defecto. Nada en este proyecto puede modificar, reiniciar, escalar ni eliminar nada.

• Sin secretos en el código ni en la configuración. El acceso a Azure se realiza mediante DefaultAzureCredential (tu az login en local; una identidad administrada cuando se despliega). Consulta el README de cada componente para conocer el modelo de autenticación y seguridad.

• Se ejecuta en local o alojado. El servidor MCP usa stdio para uso local y Streamable HTTP para el alojamiento (p. ej., Azure Container Apps); el agente se conecta a cualquiera de los dos.

Este es un proyecto de laboratorio / portafolio: seguro de ejecutar y leer, pero deliberadamente no está preparado para producción. Consulta las notas de "Modelo de seguridad" de cada componente antes de desplegarlo en cualquier lugar accesible.

Licencia

MIT.