이것은 Kali Linux를 기반으로 Docker 컨테이너 내에서 실행되는 간단한 MCP (모델 Context Protocol) 서버입니다. 서버는 보안 검사를 실행하는 도구를 제공합니다:

• run_nmap: 대상에서 nmap 스캔 실행
• run_gobuster: 웹 서버에서 디렉토리 brute force scans 실행

초기 POC이며 더 많은 도구와 기능을 곧 확장 될 것입니다. 목표는 긴 명령과 도구의 제비를 기억하지 않고 단지 자연적인 언어를 가진 pentests를 실행하는 것입니다.

요구 사항

• 도커
• 도커 컴ose

설치

1. Clone 이 저장소:

2. Docker 콘테이너를 건설하고 시작하십시오:

3. Claude 데스크톱을 구성하여 이 MCP 서버를 사용합니다.

Claude Desktop 설정 파일 편집:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 윈도우: %APPDATA%\Claude\claude_desktop_config.json

다음 구성 추가:

4. 새로운 윤곽을 적재하는 Restart Claude 데스크탑.

사용 예제

Claude Desktop에 연결되면 다음과 같은 질문을 할 수 있습니다.

• “nmap을 사용하여 192.168.1.1을 스캔하여 개방 포트를 찾을 수 있습니까?”
• “192.168.1.1에서 어떤 서비스가 실행됩니까?”
• http://example.com"에 숨겨진 감독을 찾기 위해 "Gobuster 사용]

참고

PentestMCP Server

This is a simple MCP (Model Context Protocol) server that runs within a Docker container based on Kali Linux. The server provides tools to run security scans:

• run_nmap: Run nmap scans on targets
• run_gobuster: Run directory brute force scans on web servers

It is an early POC and will be extended with more tools and features soon. To goal is to run pentests with just natural language without having to memorize long commands and lots of tools.

Requirements

• Docker
• Docker Compose

Setup

1. Clone this repository:

2. Build and start the Docker container:

   docker-compose up -d
   

3. Configure Claude Desktop to use this MCP server:

   Edit your Claude Desktop configuration file located at:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   Add the following configuration:

   {
     "mcpServers": {
       "pentest-mcp": {
         "command": "docker",
         "args": ["exec", "-i", "pentest-mcp", "python3", "/app/pentest_mcp.py"]
       }
     }
   }
   

4. Restart Claude Desktop to load the new configuration.

Usage Examples

Once connected to Claude Desktop, you can ask questions like:

• “Can you scan 192.168.1.1 with nmap to find open ports?”
• “What services run on 192.168.1.1?”
• “Use gobuster to find hidden directories on http://example.com”

Note

This server includes very basic input validation, but you should only use it in trusted environments and on targets you have permission to scan.

Customization

To add custom wordlists, uncomment the volumes section in docker-compose.yml and add your wordlists to a local directory.