Skip to main content
Glama
dev-hops

observability-mcp

by dev-hops

Azure 事件调查

一个由两部分组成的作品集项目:一个只读 MCP 服务器,暴露 Azure 可观测性工具;以及一个自主代理,驱动这些工具调查事件并生成综合根因报告。这是一个免费、自建、极简的实现,灵感来源于微软的 Azure SRE Agent——并且,与该工具的“读取器模式”一样,全程严格只读。

 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

两个组件

目录

说明

observability-mcp/

工具层。一个 Model Context Protocol 服务器(TypeScript,stdio 或 Streamable HTTP),暴露 9 个只读工具,涵盖 Application Insights 遥测、App Service 部署历史、App Service 计划指标以及 Azure 活动日志——全部通过 operation_Id 关联。认证方式为 DefaultAzureCredential(代码中无密钥)。

incident-agent/

调查者。一个独立代理(Claude Agent SDK),作为客户端连接到 MCP 服务器,自主驱动其工具——从窄范围开始,扩大时间窗口,定位起始点,识别变更内容,并在追踪中确认——然后撰写一份有证据支撑的报告。通过构造实现只读。

每个目录都是一个独立的 npm 项目,包含各自的 README,涵盖设置、配置和运行方法。从 observability-mcp/(工具)开始,然后是 incident-agent/(驱动工具的代理)。

Related MCP server: ops-agent-toolkit-mcp

设计原则

  • 始终只读。 每个工具仅调用 list* / get* / 查询 API;代理通过一个默认拒绝的单一网关路由所有工具调用。本项目中的任何内容都不能修改、重启、缩放或删除任何资源。

  • 代码或配置中无密钥。 Azure 访问使用 DefaultAzureCredential(本地使用 az login;部署时使用托管标识)。请参阅各组件的 README 了解认证和安全模型。

  • 可在本地运行或托管。 MCP 服务器支持 stdio 用于本地使用,以及 Streamable HTTP 用于托管(例如 Azure Container Apps);代理可连接至任一模式。

这是一个实验室/作品集项目——可以安全运行和阅读,但故意未达到生产环境加固标准。在部署到任何可访问的位置之前,请参阅各组件的“安全模型”说明。

许可证

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