hashgraph-online/hol-guard

hol-guard은(는) 무엇을 하나요?

AI 개발자 에이전트를 위한 안티바이러스: Codex, Claude Code, Cursor, Gemini, OpenCode, 플러그인, 스킬, MCP 서버 및 AI 하네스를 도구 실행 전에 보호합니다.

개요

HOL Guard는 AI 에이전트 보안을 위한 최전선 방어 도구입니다. 악의적인 명령, 스크립트, 플러그인 또는 MCP 서버가 실행되기 전에 이를 감지하고 차단합니다. 이는 AI 기반 개발 환경에서 발생할 수 있는 보안 위협(예: 데이터 유출, 시스템 손상, 무단 액세스)을 사전에 방지하는 데 도움이 됩니다.

주요 기능

• 사전 실행 검사: 명령어, 스크립트 및 코드 실행 전에 위험 요소를 분석합니다.
• 다중 플랫폼 지원: Codex, Claude Code, Cursor, Gemini, OpenCode 등 다양한 AI 에이전트와 통합됩니다.
• 플러그인 및 스킬 보호: AI 에이전트가 사용하는 플러그인과 스킬을 악의적인 활동으로부터 보호합니다.
• MCP 서버 검증: MCP(Model Context Protocol) 서버의 안전성을 확인하고 악의적인 요청을 차단합니다.
• 실시간 모니터링: AI 에이전트의 활동을 지속적으로 감시하고 의심스러운 행동을 신고합니다.

사용 방법

# 설치
npm install -g hol-guard

# 또는 Docker를 사용하여 실행
docker run -d --name hol-guard hashgraph-online/hol-guard

# CLI를 통해 검사 실행
hol-guard scan --path /path/to/plugin
hol-guard check --command "npm install malicious-package"

통합

Claude Code

Claude Code에서 HOL Guard를 사용하려면 claude_code.yml 설정 파일에 다음을 추가하세요:

plugins:
  - name: hol-guard
    path: /path/to/hol-guard

Cursor

Cursor 설정에서 hol-guard 확장을 활성화하세요:

{
  "extensions": {
    "hol-guard.enabled": true
  }
}

Codex

Codex 환경에서 HOL_GUARD_ENABLED=1 환경 변수를 설정하세요.

환경 변수

변수명	설명	기본값
HOL_GUARD_ENABLED	HOL Guard 활성화 여부	true
HOL_GUARD_LOG_LEVEL	로그 레벨 (debug, info, warn, error)	info
HOL_GUARD_BLOCKLIST	차단할 명령어 목록 (쉼표로 구분)	rm -rf /,wget http:,curl http:

라이선스

MIT 라이선스