한국어 · Русский (RU)

🧠 pentool-mcp-server

MCP server for Pentool — the local AI assistant for web pentesting

자체 포함된 stdio JSON-RPC 2.0 서버로, 모든 MCP 클라이언트에 AI 기능을 제공합니다 — 특히 Pentool을 위해 (BYO-LLM: 체크 항목 선택, WAF 우회, 비명시적 엔드포인트 찾기). uv로 한 번의 명령으로 설치됩니다.

왜 별도 패키지인가

MCP는 LLM 모델을 도구에 연결하는 개방형 프로토콜입니다. pentool-mcp-server는 Pentool의 MCP 계층을 재사용 가능한 PyPI 패키지로 캡슐화합니다: 로컬로 연결(stdio), 네트워크 없음, 포트 없음, 몇 초 만에 설치, 무거운 의존성 없음.

Related MCP server: pentestMCP

🔗 Pentool을 위해 제작됨

이 서버는 Pentool의 MCP 구성 요소로, 전문 웹 보안 테스트 터미널(Burp 호환 프록시, 스캐너, 스파이더, 인트루더 — 모두 TUI로 제공)입니다. Pentool의 AI를 구동합니다:

• 🎯 구체적인 대상에 대한 관련 스캔 체크 선택;

• 🛡 WAF 우회 / 페이로드 제안;

• 🕷 스파이더 크롤링 중 비명시적 엔드포인트 찾기.

전체 스택 사용해보기: uv tool install "pentool[ai]" → pentool ai setup → pentool.

⚡ 빠른 시작 (uv)

# Install uv (if not present): https://docs.astral.sh/uv/
curl -LsSf https://astral.sh/uv/install.sh | sh

# Standalone — just the MCP server
uv tool install pentool-mcp-server
pentool-mcp-server --version

# Or together with Pentool and its AI extras
uv tool install "pentool[ai]"

헬스 체크 (stdio):

echo '{"jsonrpc":"2.0","id":1,"method":"ping"}' | pentool-mcp-server
# → {"jsonrpc": "2.0", "id": 1, "result": {"status": "ok"}}

uv는 표준 설치 경로입니다 — 격리된 환경, Pentool 자체가 설치되는 방식과 정확히 같습니다. 서버를 시스템 Python에서 분리합니다.

🚀 VPS/컨테이너에 배포

서버는 포트를 열지 않으며 로컬 서브프로세스로 실행됩니다 — 모든 호스트에서 안전합니다. uv를 사용하면 시스템 Python에서 분리됩니다:

uv tool install pentool-mcp-server

전체 사용자 가이드 — docs/GUIDE.md. 러시아어 — README.ru.

🧩 MCP 도구

🔒 보안

• 기본적으로 네트워크 없음. pentool-mcp-server는 로컬 프로세스 내에서 stdio(stdin → stdout)만 수신합니다. 외부 접근은 불가능합니다 — 다른 프로세스나 다른 호스트에서도.

• 인증 없이 TCP/0.0.0.0으로 노출하지 마세요. 외부에서 네트워크 포트로 실행하면 stdin/포트에 쓸 수 있는 모든 사람이 tools/call generate(리소스 사용 + 대상 데이터를 LLM으로 전송)를 사용할 수 있습니다. MCP는 내장 인증이 없습니다 — 127.0.0.1에 바인딩하고 방화벽으로 보호하세요.

• 대상 개인정보 보호. 데이터(URL, 페이로드)는 외부 LLM 제공자가 연결된 경우에만 호스트를 떠납니다; 로컬 GGUF 모델을 사용하면 트래픽이 머신에 남아 있습니다.

더 보기 — docs/GUIDE.md.

🗺 로드맵

• stdio JSON-RPC 2.0 서버 (initialize / tools/list / tools/call / ping)

• generate, health, configure 도구

• model.py의 실제 LLM 실행기 (llama-cpp-python)

• HMAC 인증을 포함한 선택적 TCP 모드

📄 라이선스

AGPL-3.0 — Pentool과 동일한 라이선스.

지원/버그: issues · Pentool을 위해 설계됨 · 사용자 가이드