AI 모델 파일, 코드, 실시간 LLM/에이전트/MCP 엔드포인트와 저장된 에이전트 추적을 검증하고 발견 사항과 점검 공백을 보고하는 오픈소스 CLI 및 라이브러리입니다.
hashgraph-online/hol-guard
AI 에이전트의 셸 명령, 파일 접근, 패키지 설치 및 MCP 도구 호출을 실행 전에 검토하는 로컬 우선 런타임 보안 계층입니다.
- 스타
- 964
- 포크
- 197
- 열린 이슈
- 112
- 마지막 커밋
- 60분 전
어떤 프로젝트인가요?
HOL Guard는 AI 코딩 에이전트와 관련 도구를 보호하는 오픈 소스 보안 계층입니다. 셸 명령, 파일 읽기, 패키지 설치, MCP 도구 호출 같은 작업을 실행 전에 검사해 비밀 정보 노출, 파괴적인 작업, 프롬프트 인젝션, 공급망 위험을 찾아냅니다. 각 결정은 로컬 정책에 따라 허용하거나 차단하거나 승인을 요청할 수 있으며, 나중에 검토할 수 있도록 영수증으로 기록됩니다.
CLI는 초기 설정과 일상적인 작업을 지원합니다. 초기화 마법사가 지원되는 에이전트를 찾아내고, `hol-guard status`와 `doctor`로 연동 상태를 확인할 수 있으며, 명령어를 통해 승인, 영수증, 아티팩트 인벤토리 및 패키지 검사를 관리할 수 있습니다. 계정 없이 실행할 수 있으며, 선택 사항인 Guard Cloud를 사용하면 기록 공유, 팀 정책, 플릿 관리 기능을 이용할 수 있습니다. 이 프로젝트에는 에이전트 플러그인, 스킬, MCP 패키지를 린트하고 검사하는 별도의 CLI인 `plugin-scanner`도 포함되어 있습니다. 이 도구는 텍스트, JSON, Markdown 또는 SARIF 형식으로 결과를 출력하며 GitHub Action도 제공합니다.
지원 에이전트에는 Codex, Claude Code, Cursor, Gemini CLI, Cline, OpenCode, OpenClaw 등이 포함됩니다. 에이전트마다 노출하는 훅 이벤트가 달라 지원 범위도 다릅니다.
핵심 기능
- 01셸 명령, 파일 접근, 패키지 설치를 실행 전에 검토합니다.
- 02로컬 정책에 따라 작업을 차단하거나 허용하고, 승인을 요청합니다.
- 03결정 영수증을 기록하고 로컬 승인 대시보드를 제공합니다.
- 04`plugin-scanner`로 에이전트 플러그인, 스킬, MCP 패키지를 검사합니다.
- 05SARIF 보고서를 내보내고 CI 게이트용 GitHub Action을 제공합니다.
활용 사례
- Claude Code나 Codex 같은 AI 코딩 에이전트를 실행할 때 개발자 컴퓨터를 보호합니다.
- 에이전트 워크플로에서 MCP 서버 연결과 도구 호출을 승인 절차로 제어합니다.
- 플러그인이나 스킬 패키지를 공개하기 전에 보안 문제를 검사합니다.
- CI 파이프라인에 에이전트 플러그인 보안 검사를 추가합니다.
토픽
자주 묻는 질문
- hol-guard은(는) 무엇인가요?
- AI 에이전트의 셸 명령, 파일 접근, 패키지 설치 및 MCP 도구 호출을 실행 전에 검토하는 로컬 우선 런타임 보안 계층입니다. HOL Guard는 AI 코딩 에이전트와 관련 도구를 보호하는 오픈 소스 보안 계층입니다. 셸 명령, 파일 읽기, 패키지 설치, MCP 도구 호출 같은 작업을 실행 전에 검사해 비밀 정보 노출, 파괴적인 작업, 프롬프트 인젝션, 공급망 위험을 찾아냅니다. 각 결정은 로컬 정책에 따라 허용하거나 차단하거나 승인을 요청할 수 있으며, 나중에 검토할 수 있도록 영수증으로 기록됩니다.
- hol-guard은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- hol-guard은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- hol-guard은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. hol-guard의 마지막 커밋은 2026년 10월 22일입니다.
- hol-guard은(는) 어디에 사용할 수 있나요?
- Claude Code나 Codex 같은 AI 코딩 에이전트를 실행할 때 개발자 컴퓨터를 보호합니다. 에이전트 워크플로에서 MCP 서버 연결과 도구 호출을 승인 절차로 제어합니다. 플러그인이나 스킬 패키지를 공개하기 전에 보안 문제를 검사합니다. CI 파이프라인에 에이전트 플러그인 보안 검사를 추가합니다.
- hol-guard은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/hashgraph-online/hol-guard
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Tencent Zhuque Lab이 개발한 풀스택 AI 레드팀 플랫폼으로, AI 에이전트, MCP 서버, Agent Skills, AI 인프라의 보안 위험을 검사합니다.
Cisco의 Python 도구로 YARA 규칙, LLM 분석, Cisco AI Defense를 사용해 MCP 서버 등을 보안 검사합니다.
도구를 사용하는 AI 에이전트와 도구 사이에서 위험한 호출을 차단하고 민감한 결과를 가리는 호스트에 구애받지 않는 안전 미들웨어입니다.
OpenClaw와 Claude Code를 위한 보안 금고로, AI 트래픽에서 비밀 정보, 프롬프트 인젝션, 위험한 명령을 감지하고 감사 로그를 기록합니다.
샌드박스별 파일, 시스템 호출, 네트워크 정책을 적용하는 안전하고 비공개적인 자율 AI 에이전트 런타임입니다.