affaan-m/agentshield

AI agent security scanner. Detect vulnerabilities in agent configurations, MCP servers, and tool permissions. Available as CLI, GitHub Action, ECC plugin, and GitHub App integration. 🛡️

해결하는 문제

AgentShield는 AI 에이전트 설정을 보호하기 위해 설계된 보안 감사 도구로, 특히 Claude Code 설정을 대상으로 합니다. 개발자가 커뮤니티 기술을 설치하거나, MCP(Model Context Protocol) 서버에 연결하거나, 훅을 구성할 때 하드코딩된 시크릿, 과도한 권한, 프롬프트 인젝션 벡터가 포함되어 있지 않은지 알지 못한 채 행동하는 위험을 해결합니다. 이로 인해 원격 코드 실행(RCE) 또는 데이터 유출이 발생할 수 있습니다.

작동 방식

AgentShield는 .claude/ 디렉터리와 관련 설정 파일을 스캔하여 15개 모듈에 걸쳐 268개의 규칙 라이브러리를 사용해 취약점을 식별합니다. 주요 분야를 분석합니다:

시크릿 탐지: Anthropic, OpenAI 등 하드코딩된 API 키, 토큰, 자격 증명 검색.
권한 감사: 와일드카드 접근(Bash(*)) 및 위험 명령어에 대한 거부 목록 누락 표시.
훅 분석: 에이전트 훅 내에서 명령어 인젝션, 데이터 유출 패턴, 역방향 쉘 탐지.
MCP 서버 보안: 고위험 서버, 공급망 리스크(npx -y 자동 설치 포함), 보안이 취약한 네트워크 바인딩 식별.
에이전트 설정 검토: CLAUDE.md 및 서브에이전트 설정 파일 내 프롬프트 인젝션 표면, 숨겨진 지시사항, 위험한 자동 실행 지시사항 스캔.

등급별 보안 보고서(A~F)를 제공하며 CLI 도구, GitHub Action, GitHub App으로 통합 가능합니다. 또한 Claude Opus를 사용한 적대적 분석 모드도 지원합니다.

대상 사용자

특히 Claude Code를 사용하는 개발자 및 보안 엔지니어를 위한 도구로, 에이전트 설정과 제3자 확장 기능이 배포 전에 안전한지 확인하고자 하는 분들에게 적합합니다.

주요 특징

포괄적인 규칙 세트: 시크릿, 권한, 훅, MCP 서버, 에이전트 프롬프트를 포함한 268개의 규칙.
유연한 통합: npm(npx), 글로벌 설치, GitHub Action, GitHub App으로 사용 가능.
자동 수정 기능: --fix 플래그를 통해 하드코딩된 시크릿을 환경 변수 참조로 자동 교체.
문맥 인식 스코어링: runtimeConfidence를 사용해 실행 시 설정과 템플릿 또는 예제의 차이를 구분하여 문서로 인한 불공정한 점수 감점 방지.
공급망 검증: npm 레지스트리에 쿼리하여 MCP 패키지의 출처와 건강 상태 확인 가능.