agentscan은(는) 무엇을 하나요?
npm audit과 유사하지만, AI 에이전트 확장 기능을 위해 설계되었습니다. Claude 스킬, MCP 서버 및 Cursor 규칙에서 프롬프트 인젝션, 데이터 유출, 위험한 명령어 및 비밀 정보를 스캔합니다.
개요
agentscan은 AI 에이전트 스킬, MCP 서버 및 Cursor 규칙에 대한 보안 감사 도구입니다. Claude Code, Cursor 및 기타 AI 에이전트에서 사용하는 확장 기능에서 일반적인 보안 문제를 식별하는 데 도움을 줍니다.
설치
npm install -g agentscan
또는
npx agentscan@latest
사용법
디렉토리 스캔
agentscan scan ./path/to/skills
단일 파일 스캔
agentscan scan ./path/to/file.md
CI/CD 모드 (JSON 출력)
agentscan scan ./skills --json
지원되는 플랫폼
| 플랫폼 | 확장자 | 설명 |
|---|---|---|
| Claude Code | .md | AI 에이전트 스킬 파일 |
| MCP | .js, .py, .ts, .json | MCP 서버 구성 및 코드 |
| Cursor | .mdc, .cursorrules | Cursor 규칙 파일 |
검사 항목
- 프롬프트 인젝션: 악의적인 프롬프트 주입 시도 탐지
- 데이터 유출: 민감한 데이터 유출 패턴 스캔
- 위험한 명령어:
rm -rf,curl,exec와 같은 위험한 명령 식별 - 비밀 정보: 하드코딩된 API 키, 비밀번호, 토큰 감지
구성
.agentscanrc.json 파일을 생성하여 특정 규칙을 사용자 정의할 수 있습니다:
{
"rules": {
"dangerous-commands": ["rm", "sudo", "chmod"],
"exfiltration-urls": ["http://evil.com"],
"secrets": true
},
"ignore": ["node_modules/**", "*.min.js"]
}
결과 예시
┌──────────────────────┬──────────┬─────────────────────────────────────┐
│ 경고 │ 위험도 │ 위치 │
├──────────────────────┼──────────┼─────────────────────────────────────┤
│ 프롬프트 인젝션 │ 높음 │ ./skills/evil-skill.md:12 │
│ 데이터 유출 │ 중간 │ ./mcp-servers/telemetry-server.js:34│
│ 비밀 정보 발견 │ 높음 │ .cursorrules:8 │
└──────────────────────┴──────────┴─────────────────────────────────────┘
라이선스
MIT