Skip to main content
Glama
dev-hops

observability-mcp

by dev-hops

Azure インシデント調査

2部構成のポートフォリオプロジェクト:Azureの可観測性ツールを公開する読み取り専用MCPサーバーと、それらのツールを駆動してインシデントを調査し、統合された根本原因レポートを生成する自律エージェント。Microsoftの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

2つのコンポーネント

ディレクトリ

説明

observability-mcp/

ツールレイヤー。Model Context Protocol サーバー(TypeScript、stdio または Streamable HTTP)で、Application Insights テレメトリー、App Service デプロイ履歴、App Service プランメトリクス、Azure アクティビティログに対する9つの読み取り専用ツールを公開します。これらはすべて 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、デプロイ時はマネージド ID)です。各コンポーネントの README で認証とセキュリティモデルを確認してください。

  • ローカルまたはホスト環境で実行可能。 MCP サーバーはローカル使用のための stdio と、ホスティング(Azure Container Apps など)のための Streamable HTTP に対応しています。エージェントはそのいずれかに接続します。

これはラボ/ポートフォリオプロジェクトです。実行と読み取りは安全ですが、意図的に本番環境向けには強化されていません。到達可能な場所にデプロイする前に、各コンポーネントの「セキュリティモデル」の注意事項を確認してください。

ライセンス

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