Azure Incident Investigation

두 부분으로 구성된 포트폴리오 프로젝트: Azure 관찰 가능성 도구를 노출하는 읽기 전용 MCP 서버와, 이 도구를 구동하여 인시던트를 조사하고 종합적인 근본 원인 보고서를 생성하는 자율 에이전트로 이루어져 있습니다. Microsoft Azure SRE Agent의 아이디어를 차용한 무료 자체 제작 미니 버전이며, 해당 도구의 "Reader mode"와 마찬가지로 엄격히 읽기 전용으로 동작합니다.

 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

두 구성 요소

각 디렉터리는 자체 README와 함께 독립적인 npm 프로젝트로, 설정, 구성 및 실행 방법을 다룹니다. observability-mcp/(도구)부터 시작한 다음 incident-agent/(도구를 구동하는 에이전트)를 진행하세요.

Related MCP server: aws-safe-mcp

설계 원칙

• 항상 읽기 전용입니다. 모든 도구는 list* / get* / 쿼리 API만 호출하며, 에이전트는 모든 도구 호출을 단일 차단 기본 게이트를 통해 라우팅합니다. 이 프로젝트에서는 어떤 것도 수정, 재시작, 확장 또는 삭제할 수 없습니다.

• 코드나 구성에 비밀 정보가 없습니다. Azure 액세스는 DefaultAzureCredential을 사용합니다(로컬에서는 az login, 배포 시에는 관리 ID). 각 구성 요소의 README에서 인증 및 보안 모델을 확인하세요.

• 로컬 또는 호스팅 환경에서 실행 가능합니다. MCP 서버는 로컬 사용을 위해 stdio를, 호스팅(예: Azure Container Apps)을 위해 Streamable HTTP를 지원합니다. 에이전트는 둘 다 연결할 수 있습니다.

이 프로젝트는 실험실/포트폴리오 프로젝트입니다. 실행 및 읽기에는 안전하지만, 의도적으로 프로덕션 환경에 적합하도록 강화되지 않았습니다. 접근 가능한 곳에 배포하기 전에 각 구성 요소의 "보안 모델" 참고 사항을 확인하세요.

라이선스

MIT.