Skip to main content
Glama
deenesjakoruzh
dev-hops

observability-mcp

by dev-hops
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

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

Directorio

Qué es

observability-mcp/

La capa de herramientas. Un servidor Model Context Protocol (TypeScript, stdio o Streamable HTTP) que expone 9 herramientas de solo lectura sobre la telemetría de Application Insights, el historial de implementaciones de App Service, las métricas de App Service Plan y Azure Activity Log — todo correlacionado por operation_Id. Autenticación mediante DefaultAzureCredential (sin secretos en el código).

incident-agent/

El investigador. Un agente independiente (Claude Agent SDK) que se conecta al servidor MCP como cliente y maneja sus herramientas de forma autónoma — empezando de forma acotada, ampliando la ventana de tiempo, localizando el inicio, identificando qué cambió y confirmando en una traza — antes de escribir un informe respaldado por evidencia. De solo lectura por construcción.

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: ops-agent-toolkit-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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • incident-copilot

    Varshini1612
    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

  • ops-agent-toolkit-mcp

    Jeromefromcn
    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

  • mcp-incident-copilot

    ShreyAC962
    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

  • opsagent

    batpepe
    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