Icinga용 MCP 서버

mcp-server-icinga는 Claude와 같은 AI 클라이언트가 자연어를 통해 Icinga 설치와 상호작용할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다. 이 서버는 프로덕션 환경에서 Icinga를 운영하며 기존 Icinga REST API를 기반으로 일상적인 분류, 사고 조사 및 일상적인 운영을 위한 채팅 기반 인터페이스를 원하는 Linux 시스템 엔지니어를 대상으로 합니다.

이 프로젝트는 Anthropic의 Claude Code의 도움을 받아 개발되었습니다.

범위

이 서버는 세 가지 Icinga 인터페이스와 Linuxfabrik 모니터링 스택을 연결합니다:

• Icinga 2 Core REST API (포트 5665): 실시간 호스트 및 서비스 객체, 온디맨드 체크, 승인(acknowledgements), 다운타임.

• Icinga Web 2 / Icinga DB Web 모듈: Icinga Web 인터페이스의 제한 사항 내에서 더 풍부한 상태 프로젝션, 기록, 댓글, 알림.

• Icinga Director API: 객체 탐색, 서비스 템플릿 인트로스펙션, 명령 카탈로그.

• Linuxfabrik monitoring-plugins 카탈로그: 모든 체크 플러그인의 구현, 입력, 출력, 상태 및 성능 데이터. 이를 통해 서버는 서비스가 단순히 경고 중이라는 사실뿐만 아니라 왜 경고 중인지 설명할 수 있습니다.

• 시계열 데이터베이스 (기본값: InfluxDB, 모듈식): 트렌드 분석, 플래핑 분석 및 근본 원인 조사를 위한 과거 성능 데이터.

각 백엔드는 자체 모듈로 구성되어 있어 운영자가 실제로 실행 중인 기능만 연결할 수 있습니다. 서버는 기본 API가 노출하지 않는 정보를 추측하는 대신 투명하게 표시합니다.

Related MCP server: PilotOps MCP

상태

초기 개발 단계입니다. 아키텍처, 구성 및 도구 인터페이스는 불안정하며 변경될 수 있습니다.

요구 사항

• Python 3.14 이상.

• 연결 가능한 Icinga 설치 (Icinga 2 Core API, Icinga DB Web 모듈이 포함된 Icinga Web 2, Icinga Director 중 하나 이상).

• 선택 사항: 과거 성능 데이터를 위한 시계열 데이터베이스 백엔드. 기본 통합은 InfluxDB이며, TSDB 계층은 모듈식으로 설계되어 다른 백엔드를 연결할 수 있습니다.

설치

설치 지침은 첫 번째 릴리스가 나오면 문서화될 예정입니다.

구성

구성 지침은 구성 인터페이스가 안정화되는 대로 제공될 예정입니다.

관련 프로젝트

• Linuxfabrik monitoring-plugins: 이 서버가 이해하는 체크 플러그인 카탈로그.

• Linuxfabrik lib: 공유 Python 헬퍼.

• Icinga/icinga-mcp: Icinga 팀에서 제공하는 업스트림 개념 증명 MCP 서버. 범위와 아키텍처가 다릅니다.

라이선스

Unlicense에 따라 퍼블릭 도메인으로 공개되었습니다.