AI 어시스턴트가 자체 호스팅 Sn1per 설치를 구동하여 범위가 지정되고 감사된 스캔을 실행하고, 발견 사항, 포트, 서브도메인 및 기술을 구조화된 데이터로 반환할 수 있게 해주는 MCP 서버입니다.
AI 어시스턴트에서 자체 호스팅 Sn1per를 구동하세요: 범위가 지정되고 감사된, 승인된 테스트용입니다.
승인된 보안 테스트 전용입니다. Sn1per MCP 서버는 본인이 소유하거나 서면으로 명시적 테스트 허가를 받은 시스템에 대해서만, 그리고 해당 허가 범위 내에서만 사용하세요.
상태: 베타 (0.9.x). 도구 이름, 매개변수 및 출력 필드는 0.x 릴리스에 대한 호환성 약속을 따릅니다.
Sn1per MCP 서버는 이미 사용 중인 AI 어시스턴트를 자체 Linux 호스트에 설치된 Sn1per에 연결합니다. Sn1per 옆에서 stdio를 통해 로컬로 실행되며, 구성한 범위를 벗어난 대상에 대한 스캔 요청을 거부하고(제한 사항 참조), 처리하는 모든 스캔, 취소, 삭제 및 내보내기 요청을 로컬 감사 로그에 기록하며, Sn1per의 발견 사항, 열린 포트, 서브도메인 및 기술 정보를 기본적으로 비밀이 마스킹된 구조화된 데이터로 반환합니다. Sn1per Community Edition 9.x와 SE, Professional 및 Enterprise에서 사용되는 11.x 엔진을 지원하며, 에디션 매트릭스에 검증된 내용이 나열되어 있습니다. Apache-2.0 라이선스 하에 무료 오픈 소스이며, 승인된 보안 테스트 전용입니다.
서버는 호스트의 Sn1per 옆에서 실행됩니다: 수집물은 호스트에 남아 있으며, 도구 결과는 MCP 클라이언트와 그것이 사용하는 모델 서비스를 통해서만 호스트를 떠납니다. 호스트를 떠나는 항목에 대해서는 데이터 처리 및 개인정보 보호를 읽어보세요.
스캔은 Sn1per가 수행합니다. Sn1per MCP 서버는 이미 사용 중인 AI 어시스턴트가 이를 구동할 수 있게 해줍니다. 일반적인 도구 실행기 MCP 서버는 개별 명령을 노출합니다. Sn1per MCP 서버는 Sn1per의 오케스트레이션된 스캔 모드를 구동하고 범위 적용 및 감사 로그와 함께 구조화된 결과를 반환합니다.
<user>를 MCP 클라이언트를 실행하는 사용자로 바꾸세요. env 파일이 표준 구성이므로 --check는 클라이언트가 실행할 내용을 정확히 확인합니다.
pipx를 설치한 다음, 해당 사용자로 서버를 설치하세요(pipx를 sudo로 실행하지 마세요):
sudo apt install pipx
pipx ensurepath
# open a new shell, then:
pipx install sn1per-mcp==0.9.0
/home/<user>/.config/sn1per-mcp/env 환경 파일을 모드 0600으로 생성합니다:
mkdir -p /home/<user>/.config/sn1per-mcp
install -m 0600 /dev/null /home/<user>/.config/sn1per-mcp/env
이 줄을 여기에 넣은 다음, 플레이스홀더를 테스트 권한이 있는 대상으로 교체하세요. 플레이스홀더 자체는 거부되므로(scope_invalid), 교체하기 전까지는 아무것도 스캔되지 않습니다.
SNIPER_MCP_SCOPE=<authorized-targets>
설정을 확인합니다. 출력에는 sudo 규칙이 지정해야 하는 Sn1per CLI의 realpath가 포함됩니다:
/home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env --check
실제 경로(/usr/share/sniper/sniper, 표준 설치 기준)를 사용하여 sudoers 드롭인을 추가합니다. 클라이언트가 root로 실행되는 경우 이 단계를 건너뜁니다. 전체 단계: docs/install.md.
sudo visudo -f /etc/sudoers.d/sn1per-mcp
<user> ALL=(root) NOPASSWD: /usr/share/sniper/sniper
Claude Code에 서버를 등록합니다(기타 클라이언트: docs/clients.md):
claude mcp add sn1per -s user -- /home/<user>/.local/bin/sn1per-mcp --env-file /home/<user>/.config/sn1per-mcp/env
새 클라이언트 세션을 시작하고 "Run sniper_status"라고 요청합니다.
0.9.0 클라이언트 테스트(2026-10-12)를 통과한 클라이언트만 나열합니다. 구성 경로, 승인 설정 및 클라이언트별 참고 사항은 docs/clients.md에 있습니다.
| 클라이언트 | 상태 | 도구 삭제 및 내보내기 (MCP elicitation 필요) |
|---|---|---|
| Claude Code (2.1.284) | 검증됨 | 예, 대화형 세션에서; SDK 호스트가 없는 claude -p는 확인을 취소하므로 아무것도 삭제되거나 내보내지지 않음 |
| Codex CLI (0.125.0) | codex exec에서만 검증됨 | codex exec에서는 불가, 확인을 거부함; 대화형 Codex 인터페이스는 아직 테스트되지 않음 |
| 웹, 모바일 및 원격 커넥터 클라이언트 | 0.9.0에서 지원되지 않음 (stdio 전용) | 해당 없음 |
Claude Code: 빠른 시작의 한 줄 명령(5단계). Codex CLI: config.toml 항목과 export_workspace에 필요한 승인 설정은 docs/clients.md에 있습니다. 로컬 stdio 서버를 시작하는 다른 클라이언트는 0.9.0에서 아직 테스트되지 않았습니다.
Sn1per가 다른 머신에 있거나 클라이언트가 macOS 또는 Windows인가요? SSH 레시피(Linux OpenSSH 클라이언트로 검증됨; Windows 및 macOS 클라이언트는 문서화되었으나 미검증), WSL2(문서화되었으나 미검증) 및 Docker 레시피(문서화되었으나 미검증)는 docs/remote.md를 참조하세요.
서버는 호스트의 Sn1per CLI에서 에디션과 엔진을 감지합니다. "검증됨"은 2026-10-12의 0.9.0 검증 실행에서 실행되었음을 의미하고, "예상됨"은 알려진 차단 요인이 없지만 실행되지 않았음을 의미합니다. 도구별 결과, 실행된 스캔 모드 및 실행 후 이루어진 수정 사항은 모드 표 및 에디션별 참고 사항과 함께 docs/editions.md에 있습니다.
| 에디션 | 엔진 방언 | 상태 |
|---|---|---|
Sn1per Community Edition 9.2 (a5450bc의 저장소 master) | 9.x | 2026-10-12 검증됨, 서버가 root로 실행됨 |
| 이후 Sn1per Community Edition 9.x 릴리스 | 9.x | 예상됨 |
| Sn1per SE 11.0 및 11.1 | 11.x | 2026-10-12 검증됨 (11.0은 root 및 sudo를 통한 일반 사용자로, 11.1은 root로) |
| Sn1per Enterprise, 11.3 개발 빌드 | 11.x | 2026-10-12 검증됨, sudo를 통한 일반 사용자로 |
| 11.2를 포함한 기타 11.x 릴리스 | 11.x | 예상됨 |
| Sn1per Professional 2026 | 11.x | SE 및 Enterprise와 동일한 11.x 엔진을 사용함; Professional 설치에서는 아직 실행되지 않음 |
| Sn1per Community Edition 9.2 미만 | - | 지원되지 않음 |
플랫폼: Linux 전용. Kali Rolling (amd64)에서 검증됨. Ubuntu 24.04: 설치 및 MCP 세션 검증됨 (Ubuntu에서는 스캔이 실행되지 않음). Debian 12 및 13과 Parrot: 예상됨. Ubuntu 22.04 및 Kali 2022.x: uv로 관리되는 Python 또는 별도로 설치된 Python 3.11 이상에서만 예상됨; 해당 시스템 Python 3.10은 거부됨. BlackArch: 예상됨; PATH에 sniper 심볼릭 링크가 필요함. arm64: 예상됨. macOS 및 Windows는 서버 호스트로 지원되지 않음; SSH를 통해 클라이언트 호스트로 사용하세요 (docs/remote.md).
전체 매개변수, 예제 결과 및 오류 코드: docs/tools.md.
| 도구 | 기능 | 읽기 전용 또는 상태 변경 | 사용 가능 여부 |
|---|---|---|---|
sniper_status | 감지된 에디션, 사용 가능한 스캔 모드, 구성된 범위 및 스캔이 불가능할 수 있는 이유를 보고합니다 | 읽기 전용 | 항상 |
list_workspaces | 호스트의 Sn1per loot 워크스페이스를 나열합니다 | 읽기 전용 | 항상 |
scan_status | 스캔의 상태와 수정된 로그 꼬리, 또는 워크스페이스에서 실행 중인 항목이 있는지 여부를 보고합니다 | 읽기 전용 | 항상 |
get_findings | 심각도, 제목, 위치 및 호스트와 함께 발견 사항을 읽습니다 | 읽기 전용 | 항상 |
get_ports | 프로토콜, 서비스 및 버전과 함께 열린 포트를 읽습니다 | 읽기 전용 | 항상 |
get_subdomains | 발견된 서브도메인을 읽습니다 | 읽기 전용 | 항상 |
get_technologies | 감지된 웹 기술을 읽습니다 | 읽기 전용 | 항상 |
grep_loot | 하나의 워크스페이스(또는 운영자가 요청하는 경우 모든 워크스페이스)의 loot 파일에서 문자열 또는 확장 정규식을 검색합니다 | 읽기 전용 | 항상 |
sniper_scan | root 권한으로 하나의 대상에 대한 Sn1per 스캔을 시작하고 작업 핸들을 반환합니다 | 상태 변경: 대상에 트래픽을 전송합니다 | 항상 등록됨; 범위를 구성할 때까지 모든 대상을 거부합니다 |
cancel_scan | 이 서버가 시작한 스캔을 중지합니다 | 상태 변경 | 항상 |
delete_workspace | 사람이 워크스페이스 이름을 입력한 후 root 권한으로 하나의 워크스페이스와 해당 스캔 데이터를 영구적으로 삭제합니다 | 상태 변경: 되돌릴 수 없음 | SNIPER_MCP_ENABLE_DESTRUCTIVE=1 및 MCP elicitation을 지원하는 클라이언트에서만 |
export_workspace | 사람이 워크스페이스 이름을 입력한 후 서버의 상태 디렉터리에 하나의 워크스페이스에 대한 tar.gz 아카이브를 작성합니다 | 상태 변경: 파일을 작성합니다 | SNIPER_MCP_ENABLE_DESTRUCTIVE=1 및 MCP elicitation을 지원하는 클라이언트에서만 |
모든 설정, 범위 문법 및 명령줄 플래그: docs/configuration.md.