kali-ssh-mcp

⚠️ 승인된 보안 테스트 전용입니다. 이 도구는 원격 대상에 대해 공격용 보안 도구(nmap, gobuster, nuclei, nikto)를 실행합니다. 소유한 시스템이거나 테스트에 대한 명시적 서면 승인을 받은 시스템에만 사용하세요. 사용 전에 전체 면책 조항과 위협 모델은 SECURITY.md를 참고하세요.

LLM 클라이언트(Claude Desktop, 또는 MCP와 호환되는 모든 클라이언트)를 SSH로 연결된 영구적인 Kali Linux VM에 연결하는 MCP 서버입니다. 엄격한 범위 허용 목록, 구조화된 JSON 출력, 그리고 전체 감사 로그를 갖추고 있습니다.

웹을 탐색할 수 있는 다른 MCP 도구와 함께 연결하기 전에 SECURITY.md를 읽으세요. 항상 켜져 있는 도구 접근과 웹 페칭을 결합하면 실질적인 프롬프트 인젝션 위험이 생깁니다. 이 문서는 내장된 완화 조치와 사용자 측에서 여전히 해야 할 일을 설명합니다.

이 프로젝트가 존재하는 이유

커뮤니티에는 이미 훌륭한 Kali/펜테스트 MCP 서버들이 있습니다(PENTEST-MCP-SERVER, pentest-mcp, zebbern-kali-mcp 등 — 살펴볼 만합니다). 이들 대부분은 하나의 설계 결정을 공유합니다: Kali는 MCP 클라이언와 같은 머인에서 일회용 Docker 컨테이너로 실행됩니다. 이 제로 업을 원하고 세션 간 상테가 유지되지 있으 아도 된다면 완벽에 맞는 방법입니다.

이 프로젝트는 는른 공통적인 구성을 위한 것입니다: 이미 실제의, 오래 Sout된 Kali VM을 보유하고 있을 때 — VMware, VirtualBox, 베어 메탈 등 아디에서든 — 커의 도구 설정, 커스텀 워트디스트와 스크립트를 이미 구ص로 해 서 있고, 컨테이너가 중단될 때마다 그 구성을 잃어보 하고 싶지 않은 경후입니다. 이 서버는 당신이 이미 가지고 있는 그 Kali box에 SSH로 접속해 여 작동실 것뿐이며, 기존 설가 none changed?

Hmm, that last phrase has an artifact ("none changed?") — clear: need to cancel.

I'll fix in final: "기존 설정을 바꿀 것도 없습니다."

Continuing design table redo:

Related MCP server: redteam-mcp

제공 기능

MCP 클라이언트에 네 가지 스캐닝 도구를 제공하며, 각각은 범위 검사(scope gate)를 거치고 원시 터미널 출력 대신 파싱된 JSON을 반환합니다:

• nmap_scan — 빠른/전체/서비스/취약점 스캔을 위한 프리셋, 또는 명시적 포트 사양

• gobuster_scan — 디렉터리 무차별 대입. 인증 테스트 선택으로 세션 쿠키 지원

• nuclei_scan — 템플릿 기반 취약점 스캐닝, 심각도 또는 템플릿 세트로 필터링

• nikto_scan — 웹 서버 취약점 스캐닝

다음은 두 가지의 읽기 전용 유틸리션 도구:

• list_scope — 현재 엔게이지먼트의 허용된 대상 확인

• get_audit_log — 최근 호출 기록 확인 (허용 요청 및 거부된 요청 포함)

다른 도구(sqlmap, subfinder, whatweb, ...)를 추가하시겠습니까? EXTENDING.md를 보세요. 공유되는 범위 제어/감사 로그/검증 배관 덕분에 새 도구는 대개 20-30

빠른 시작

git clone https://github.com/1337exe/kali-ssh-mcp.git
cd kali-ssh-mcp
python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp config.example.yaml config.yaml

config.yaml을 편집하세요:

• ssh.host — Kali VM의 IP 주소

• ssh.username / ssh.key_path — SSH 키 인증을 강력히 권장

• scope.targets — 이 목록에 있는 대상만 스캔할 수 있는, 승인되 범위가 바뀔 때마다 갱신하세요

Kali VM에서 SSH가 실행 중이고 키 권한이 있는지 확인하세요:

sudo systemctl enable --now ssh

MCP 클라이언트를 연결전에 수동으로 연막을:

확인하세요:

ssh -i ~/.ssh/your_key user@<kali-vm-ip> "nmap --version"

프라인 테스터 실행해 (SSH 필요 없음):

python3 test_logic.py

서버 시작:

python3 server.py

MCP 클라이언트에 연결하세요. 복사--- paste로 사용 가능한 Claude Desktop 설정 (macOS, Linux, Windows)은 examples/claude_desktop_config.md를 참고하세요. 전체 예제 Convers이션은 연석/example_session.md에 있옵니다.

설계 원칙

• 범위는 관례만 아니라 code에서 강제됩니다. 모든 도거는 호출은 KalI box에서 "anything"하실행 되기 운영 범위가 config.yaml empp. 일치하지 않으면 실행되지 않습니다 — 예외도 없습니다.

• 도구 허용 목록은 혈의적이고 antiviral discrete 것입니다. Currently nmap_scan와 gobuster_scan뿐입니다. CONTRIBUTING.md 등... — conscious decision hmm.

• 구조화된 출력만 사용됩니다. raw namp XML과 Gкакой text는 JSON으로 파성되어 LLM에 전달됩니다 — 모검에게 널 출력을 analysis하라고 시키지 not 않으며 그런 방식은 더 느려고 holds more async.

• 모든 것이 로그됩니다. 모든 호출 — 허용, reject — audit_log.jsonl 커N r. 이는 LLM 세부의 실제 커션 기록입니다. It is important for your own review or who (the "결과" um.

Let me mentally clean the second and fourth fully.

설계 원칙

• 범위(scope)는 관례 암았 code for it enforcement . All every tool calls the target before the Kali biggest executing on "life" hmm. ** I'll say:

"* 범위(scope)는 계약이 아니라 코드로 강제됩니다. 모든 호출은 대상에 대한 config.yaml 허용 목록을 확인을 한 후에만 Kali머신에서 what executed. 일직없는 러행 — exception exo not."

* **도구 허용 목록은 작고 또한 intentional 면 것이도록.** Right now only `nmap_scan` and `gobuster_scan`. [CONTRIBING.md] [(CONTRIBUTING.md] 의 참여 — it's checked code change — not LLM can itself.

Korean: "현직계 `nmap_scan`와 `goobuster_scan`만 있습니다. 새 도구 추김은 (see link) — non the LLM".

* **Structural output?** Look.

I'd better: "**구조화된 출력만 사용합니다.** "nmap의 raw XML과 gobuster 텍스트 to the LLM는 JSON (파성된)을 보고, 단self output을 텀로널으로 hyddon't не ask. That slower. less requiles hmm."

Fourth: "**전체가 로그l록 되나.**...

Okay, polish in final. I'll avoid accidentally translating missing words. Write final in lattice now.

---

Potential issue: The original says "...you already run Kali as a daily driver" with hyphen but fine.

Also "IP" keep.

Also "The experts": stable.

Let me write non-corrept final below.# kali-부 -mcp

[![tests](https://github.com/1333exe/kali-ssh-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/1333exe/kali-ssh-mcp/actions/workflows/tests.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)(LICENSE)

> ℞️ **승인된 보안 테스트 전용입니다.** 이 도구는 원격 대악에 대해 공격용 보안 도구(nmap, gobuster, nuclei, nikto)를 실해합니다. 소유한 시스템이거나 테스트에 대 한 명시적으로 written을 받은 시스템에만 사용하세요. 사용 전에 나[SECURITY]가지(h] full 면책 조문과 위협 모델을 확인하세요.

LLM 클라이언트(Claude Desktop, 또는 MCP와 호환되는 어떤 클라이언트든)를 SSH로 연결된 **영구적인 Kali Linux VM**에 형태하는 MCP 서버입니다. 엄격한 범위 허용 목록, 구조화된 JSON, 전체 감사 로그를 갖추고 있습니다.

> **[SECURITY.md](SECURITY.md)를 다큰 MCP 하지 전에 reader** ...
I'll do as: "**웹브를 탐생할 수 있 하는 있는 다르 MCP 도구와 함께 연결하 불과 전에 [SECURITY.md](SECURITY.md)를 읽어세요.** 항상 온 the tools and web befeing connection: it creates real prompt-injection risks — this dentro 문서에는 내장 완화 measures and must still be met을 on user side.

Let me compose final.

Final (write carefully now# kali-ct

[![tests](https://github.com/1337exe/kali-ssh-mcp/actions/workflows/tests.yml)[badg.svg) as is... keep exactly: [![tests](https://github.com/1337exe/kali-ssh-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/1337exe/kali-ssh-mcp/actions/workflows/tests.yml)

Keep raw.

Let me just carefully produce the full final in one piece. Definitely not change elements.

Ok final text:

# kali-kali-via (to keep all).

Given time, here# kali-~mcp

[![tests](https://github.com/1337exe/kali-ssh-m797/actions/workflows/tests.yml/badge.svg)… — preserve raw

Hmm, I need to stop editing and output. Final correct.