snyk/agent-scan

Snyk Agent Scan이란?

Snyk Agent Scan은 컴퓨터에서 에이전트 구성 요소(예: MCP(모델 제어 프로토콜) 서버, 에이전트 도구, Claude, Cursor, GitHub Copilot, Gemini CLI 등 AI 어시스턴트가 사용하는 에이전트 스킬)를 찾는 명령줄 보안 스캐너입니다. 그런 다음 이러한 구성 요소에 프롬프트 인젝션, 도구 중독, 숨겨진 맬웨어 페이로드, 하드코딩된 비밀 및 기타 위험한 동작과 같은 알려진 위협이 있는지 확인합니다.

작동 방식(높은 수준)

발견 – 도구는 파일 시스템(시스템 전체, 사용자별, 프로젝트 및 플러그인 위치)을 탐색하고 지원되는 에이전트의 구성 파일을 자동으로 찾습니다. 각 에이전트가 macOS, Linux, Windows에서 MCP 정의와 스킬 파일을 저장하는 위치를 알고 있습니다.
선택적 동의 – 로컬 명령으로 실행되거나 원격 URL에 연결되는 MCP 서버의 경우 CLI는 각 연결을 승인하도록 요청합니다(--dangerously-run-mcp-servers 플래그를 사용하지 않는 한).
분석 – 발견된 구성 요소(비밀은 제거됨)는 Snyk의 클라우드 분석 API로 전송되어 14~15가지 보안 위험 카탈로그에 대해 평가됩니다.
보고서 – CLI는 각 위험을 점수화하고 영향을 받는 구성 요소를 나열하는 사람이 읽을 수 있는 보고서(또는 JSON)를 출력합니다. 출력 형식은 v0.5의 "문제 코드"에서 v0.6의 위험 기반 점수 시스템으로 변경되었습니다.

주요 기능

기능	설명
자동 발견	여러 에이전트(Claude, Cursor, VS Code, Copilot, Gemini, Windsurf 등)의 MCP 구성, 도구 및 스킬 파일을 OS 전반에서 찾습니다.
위험 카탈로그	프롬프트 인젝션, 신뢰할 수 없는 콘텐츠, 개인 데이터 노출, 파괴적 기능, 악성 코드, 비밀 유출, 의심스러운 다운로드 등을 감지합니다.
두 가지 출력 스타일	v0.5 – 문제 코드 목록(폐기 예정). v0.6+ – 숫자 점수가 있는 위험 지표.
독립 실행형 바이너리 및 `uvx` 설치	npm 패키지 없음; Python 기반 `uvx` 러너 또는 사전 빌드된 바이너리를 다운로드하여 실행합니다.
백그라운드/MDM 모드	엔터프라이즈 전체에 배포하여 주기적으로 실행하고 결과를 Snyk Evo로 푸시할 수 있습니다.
안전 경고	MCP 서버에 대한 명시적 동의, 샌드박스 권장 사항, 클라우드 메타데이터 엔드포인트를 피하기 위한 네트워크 주소 필터링.
검증	바이너리 무결성을 위해 GPG 서명된 릴리스 체크섬과 SBOM이 제공됩니다.

누가 사용해야 하나요?

보안 팀 – 직원 머신의 AI 에이전트 공급망에 대한 가시성이 필요한 경우.
개발자 – 사용자 지정 에이전트 스킬을 구축하거나 유지 관리하고 게시 전에 로컬에서 검증하려는 경우.
엔터프라이즈 – Snyk Evo를 사용하여 플릿 전반의 에이전트 관련 위험을 모니터링하는 경우.

시작하기(빠른 단계)

Snyk 계정을 만들고 API 토큰을 복사합니다.
토큰을 내보냅니다: export SNYK_TOKEN=your‑api‑token.

스캐너를 실행합니다 – 다음 중 하나:

# uv 사용(권장)
uvx snyk-agent-scan@latest               # 전체 머신
uvx snyk-agent-scan@latest ~/.vscode/mcp.json   # 특정 구성

또는 GitHub 릴리스 페이지에서 바이너리를 다운로드하여 실행합니다.

동의 프롬프트를 검토합니다 – 연결될 MCP 서버가 있는 경우.
생성된 보고서를 읽습니다; 높은 점수의 위험은 패치, 제거 또는 재구성이 필요한 구성 요소를 나타냅니다.

제한 사항 및 주의 사항

CLI 출력은 실험적입니다. Snyk는 릴리스 간 필드 이름이나 위험 점수의 안정성을 보장하지 않습니다.
MCP 구성을 스캔하면 명령을 실행하거나 외부 네트워크 호출을 할 수 있습니다 – 신뢰할 수 없는 스캔은 샌드박스 내에서 실행하세요.
발견 테이블에 나열된 에이전트만 지원됩니다. 새 에이전트는 명시적으로 추가해야 합니다.
백그라운드 스캔은 자동으로 원격 MCP 서버에 연결합니다. --dangerously-run-mcp-servers 플래그는 신뢰할 수 있는 환경에서만 사용해야 합니다.

자세히 알아보기

기술 보고서(에이전트 스킬 위협에 대한): .github/reports/skills-report.pdf.
CLI 참조: docs/cli-reference.md.
위험 정의: docs/risks.md(v0.6+) 및 docs/issue-codes.md(v0.5).
바이너리 검증 가이드는 README의 Verifying Standalone Binaries 섹션에 있습니다.

위의 모든 정보는 프로젝트의 README에서 직접 가져온 것이며 추가 기능은 추론되지 않았습니다.