🔴 Red Team MCP 서버

Kali Linux Docker 컨테이너 내에서 20개의 실제 해킹 도구를 실행하고, 이를 Cursor, Claude 또는 MCP 호환 IDE와 같은 AI 어시스턴트에 직접 연결하는 강력한 모의 해킹 MCP 서버입니다.

명령어를 수동으로 입력하는 대신, 다음과 같이 평문 영어로 질문하기만 하면 됩니다:

"192.168.1.1의 포트를 스캔해줘" "example.com의 서브도메인을 찾아줘" "이 사이트에 SQL 인젝션 취약점이 있는지 확인해줘"

AI가 적절한 도구를 호출하여 Kali Linux에서 실행하고 결과를 알려줍니다.

🛠️ 포함된 도구 (총 20개)

✅ 요구 사항

시작하기 전에 다음 항목이 설치되어 있는지 확인하세요:

• Git — https://git-scm.com/downloads

• Docker Desktop — https://www.docker.com/products/docker-desktop (Linux 컨테이너 활성화)

• Python 3.11 — https://www.python.org/downloads/release/python-3110 (서버를 수정하려는 경우에만 로컬에 필요하며, 컨테이너가 나머지 모든 것을 처리합니다)

• MCP 호환 IDE: Cursor, VS Code + Kiro, Claude Desktop 등.

Python 버전 참고: 이 프로젝트는 Python 3.11+용으로 작성되었습니다. Docker 컨테이너는 Kali에 내장된 Python 3(3.12)를 사용합니다. 둘 다 문제없이 작동합니다.

🚀 설치 — 단계별 가이드

1단계 — 저장소 복제

git clone https://github.com/YOUR_USERNAME/redteam-mcp.git
cd redteam-mcp

2단계 — Docker 이미지 빌드

이 과정은 Kali Linux를 다운로드하고 20개의 도구를 모두 설치합니다. 처음 실행 시 10~20분 정도 소요됩니다.

docker build -t redteam-mcp:latest .

이 작업은 한 번만 수행하면 됩니다(프로젝트를 업데이트할 때 제외).

3단계 — 컨테이너 시작

Windows (PowerShell):

.\run.ps1

Mac / Linux:

bash run.sh

실행 중인지 확인:

docker ps

redteam-mcp의 상태가 Up으로 표시되어야 합니다.

4단계 — IDE 연결

IDE에서 MCP 설정 파일을 열고 다음을 붙여넣으세요:

{
 "mcpServers": {
 "redteam-kali": {
 "command": "docker",
 "args": [
 "exec", "-i", "redteam-mcp",
 "/app/.venv/bin/python", "/app/src/server.py"
 ],
 "disabled": false,
 "autoApprove": []
 }
 }
}

붙여넣을 위치:

붙여넣은 후 IDE 창을 새로고침하세요 (Ctrl+Shift+P → Reload Window).

5단계 — 질문 시작

준비가 완료되었습니다. 자연어로 입력하세요:

Scan ports on scanme.nmap.org
Find subdomains of tesla.com
Check if http://testphp.vulnweb.com has SQL injection
Detect the WAF on cloudflare.com
Run a nikto scan on http://testphp.vulnweb.com

📋 일일 사용 가이드

프로젝트 시작

.\run.ps1

그런 다음 IDE 창을 새로고침하세요.

작업 완료 후 중지

docker stop redteam-mcp

컨테이너 재시작

docker restart redteam-mcp

전체 초기화 (문제가 발생한 경우)

docker rm -f redteam-mcp
.\run.ps1

이미지 재빌드 (Dockerfile 또는 server.py 수정 후)

docker rm -f redteam-mcp
docker build -t redteam-mcp:latest .
.\run.ps1

컨테이너 로그 확인

docker logs redteam-mcp

컨테이너 내부 셸 열기

docker exec -it redteam-mcp /bin/bash

⚠️ 법적 고지

이 도구들은 본인이 소유하거나 테스트에 대한 명시적인 서면 허가를 받은 시스템에만 사용하십시오. 무단 스캔은 불법입니다. 예제에서 사용된 합법적인 테스트 대상은 scanme.nmap.org입니다(nmap 프로젝트에서 이 목적으로 제공함).

📁 프로젝트 구조

redteam-mcp/
├── src/
│ └── server.py # MCP server with all 20 tools
├── Dockerfile # Kali Linux multi-stage build
├── requirements.txt # Python deps (mcp only)
├── run.ps1 # Start container (Windows)
├── run.sh # Start container (Mac/Linux)
└── .kiro/
 └── settings/
 └── mcp.json # IDE MCP config

Resources

• GitHub Repository
Need Help?Related Servers