Rapid-dissolve862/zabbix-mcp-server

zabbix-mcp-server은(는) 무엇을 하나요?

Zabbix를 MCP 클라이언트에 연결하여 Claude, Codex, VS Code, JetBrains에서 전체 API 액세스를 제공합니다.

개요

이 MCP 서버는 Zabbix 모니터링 시스템과의 통합을 가능하게 합니다. 지원되는 MCP 클라이언트(예: Claude Desktop, Codex CLI, VS Code, JetBrains IDE) 내에서 직접 Zabbix API에 대한 풀 액세스를 제공합니다.

주요 기능

• 호스트 관리: 호스트 조회, 생성, 업데이트, 삭제
• 문제 관리: 트리거 문제 및 알림 확인
• 템플릿 관리: 템플릿 조회 및 연결
• 대시보드 및 맵: 네트워크 맵 및 대시보드 검색
• 이벤트 처리: 이벤트 세부 정보 및 확인

전제 조건

• Zabbix 인스턴스(버전 5.0 이상 권장)
• Zabbix API 자격 증명(사용자 이름 및 비밀번호, 또는 API 토큰)
• Node.js 18 이상(npm 패키지의 경우)

설치

npm 글로벌 설치

npm install -g zabbix-mcp-server

또는 저장소 복제

git clone https://github.com/Rapid-dissolve862/zabbix-mcp-server.git
cd zabbix-mcp-server
npm install
npm run build

설정

MCP 클라이언트의 설정 파일(예: Claude Desktop의 claude_desktop_config.json)에 서버를 추가합니다.

환경 변수

변수	설명	필수
ZABBIX_URL	Zabbix API URL(예: https://your-zabbix-server/api_jsonrpc.php)	예
ZABBIX_USER	Zabbix 사용자 이름	예(토큰 없을 시)
ZABBIX_PASSWORD	Zabbix 비밀번호	예(토큰 없을 시)
ZABBIX_TOKEN	Zabbix API 토큰	예(사용자/비밀번호 없을 시)

예시 설정

{
  "mcpServers": {
    "zabbix": {
      "command": "npx",
      "args": ["zabbix-mcp-server"],
      "env": {
        "ZABBIX_URL": "https://your-zabbix-server/api_jsonrpc.php",
        "ZABBIX_USER": "admin",
        "ZABBIX_PASSWORD": "password"
      }
    }
  }
}

API 토큰 사용 시:

{
  "mcpServers": {
    "zabbix": {
      "command": "npx",
      "args": ["zabbix-mcp-server"],
      "env": {
        "ZABBIX_URL": "https://your-zabbix-server/api_jsonrpc.php",
        "ZABBIX_TOKEN": "your-api-token"
      }
    }
  }
}

사용 예시

zabbix-mcp-server가 설치된 MCP 클라이언트에서 다음과 같은 작업을 수행할 수 있습니다:

• "모든 호스트 목록 보여줘"
• "최근 문제 알림 확인"
• "'Webサーバー' 템플릿 찾기"
• "호스트 'db-server-01' 세부 정보 조회"
• "'Network Core' 맵 표시"

지원 플랫폼

• Claude Desktop - claude_desktop_config.json에 설정
• Codex CLI - 코드 편집기 내 에이전트 지원
• VS Code - MCP 지원 확장 프로그램을 통해 사용 가능
• JetBrains IDE - MCP 지원 플러그인을 통해 사용 가능

문제 해결

• Zabbix URL이 정확하고 API 엔드포인트에 접근 가능한지 확인하세요.
• API 자격 증명에 충분한 권한이 있는지 확인하세요.
• Zabbix 서버와 클라이언트 간 네트워크 연결을 확인하세요.

라이선스

MIT