FishCodeTech/muteki

Project Muteki (無敵): Open-source AI-powered offensive security harness for automated penetration testing.

Project Muteki – 멀티 에이전트 보안 자동화 프레임워크

개요

대규모 언어 모델(LLM) 에이전트의 군집을 실행하여 침투 테스트 및 CTF 문제를 자동으로 해결할 수 있게 해주는 오픈소스 Python 중심 프레임워크입니다.
Coordinator(“Planner”)가 일련의 Worker engines – Claude, Codex, Cursor, Pi, OMP, Kimi, Grok, OpenCode – 을 스케줄링하며, 각각은 벤더별 CLI와 통신하고 명령을 실행하며 증거를 반환합니다.
UI는 웹 앱(백엔드는 포트 8000, 프론트엔드는 3001)으로, 여기서 에이전트를 구성하고, 문제를 업로드하고, 군집의 진행 상황을 지켜볼 수 있습니다.

주요 기능

완전 자동 CTF 해결 – 저자들은 NYU CTF Bench에서 200/200, RIFFHACK 2026에서 톱 10 진입, Yunjing blackmaze 레인지에서 first‑blood를 보고했습니다.
하이브리드 런타임 – Worker는 호스트 머신에서 로컬로 실행하거나 Docker 컨테이너 내에서 실행할 수 있습니다. 후자는 완전한 CTF 툴체인이 포함된 사전 빌드 이미지를 제공합니다.
Planner 및 Titler 모델 – 별도의 LLM 엔드포인트가 어떤 단계를 수행할지 결정하고 각 단계의 제목을 생성할 수 있습니다.
증거 추적 – 모든 명령, 도구 호출, 후보 flag가 실행별 워크스페이스에 저장되며, 실행 후 markdown write‑up을 생성할 수 있습니다.
다중 워크스페이스 – 기본 단일 작업 모드 외에도 멀티턴 대화 및 원격 CTF 플랫폼 통합을 위한 실험적 Conversation 및 Competition 워크스페이스가 있습니다.

시작하는 방법

필수 요구 사항 설치 – Python ≥ 3.13, uv, Node.js/npm, 그리고 최소 하나의 지원되는 Agent CLI(예: Claude, Codex 등).
repo를 클론하고 init.sh 스크립트를 실행하여 Python 종속성을 설치합니다.
./run.sh web으로 웹 UI를 시작하고 http://127.0.0.1:3001을 엽니다.
UI에서 Agent 자격 증명(API 키 또는 CLI 로그인)을 추가하고, 하나 이상의 Worker를 활성화하고, Local 또는 Container 런타임을 선택하고, Planner 엔드포인트를 구성합니다.
문제 설명, 대상 URL, flag 형식 및 모든 파일을 입력하여 단일 작업을 생성한 다음 Dispatch swarm을 클릭합니다.
Coordinator의 메시지, Worker의 도구 호출, 후보 flag가 실시간으로 나타나는 것을 확인합니다. 언제든지 군집을 일시 중지, 동결 또는 중지할 수 있습니다.

일반적인 워크플로

단계	작업
설정	OS별 스크립트(macOS에서는 `./ctf-tools/setup.sh`, Linux에서는 `setup-ubuntu.sh`)를 설치하여 일반적인 펜테스트 도구(nmap, gobuster 등)를 확보합니다.
구성	선택한 LLM 엔진의 API 키/토큰을 추가하고, Worker를 활성화하고, Planner 모델을 선택합니다.
실행	문제를 제출합니다. Planner가 Steps를 생성하고, Worker가 명령을 실행하며, 증거가 자동으로 수집됩니다.
검토	생성된 증거를 확인하고, 후보 flag를 복사하고, 오탐을 표시하거나, 시스템에 write‑up 생성을 요청합니다.
반복	기존 워크스페이스로 군집을 재시작하여 추가 flag를 계속 찾습니다.

안전 및 법적 고지

Muteki는 대상 서비스에서 임의의 명령을 실행할 수 있으므로, 저자들은 자신이 소유하거나 명시적으로 테스트 허가를 받은 시스템에서만 실행할 것을 강조합니다.
이 repository에는 저자가 이 도구로 수행되는 어떠한 무단 공격에 대해서도 책임지지 않는다는 면책 조항이 포함되어 있습니다.

릴리스 상태

최신 안정 버전 0.4.5(2026년 5월). macOS 데스크톱 앱(Apple Silicon 및 Intel)과 원격 Muteki 서비스 지원을 포함합니다. Windows/Linux 데스크톱 번들은 아직 제공되지 않습니다.
8개의 활성 CLI engines. DeepSeek Harness는 나열되어 있지만 현재 사용할 수 없습니다.
이 프로젝트는 활발히 유지 관리되고 있습니다(star‑history 차트, issue tracker, 토론 QR code).

누가 사용할 수 있을까

위의 모든 정보는 repository의 README에서 직접 가져온 것이며, 추가 기능을 추론한 것이 아닙니다.