これは、Kali Linux に基づく Docker コンテナ内で実行されるシンプルな MCP (Model Context Protocol) サーバーです。 サーバは、セキュリティスキャンを実行するためのツールを提供しています。

• [run_gobuster]: ディレクトリの brute 強制スキャン を Web サーバーで実行する

初期のPOCであり、今後より多くのツールや機能で拡張されます。 目標は、長いコマンドやたくさんのツールを記憶しなくても自然言語でペテストを実行することです。

要件

• ドッカー
• ドッカーコンポーズ

セットアップ

1. このリポジトリをクローンする:

2. Dockerコンテナのビルドと起動:

3。 このMCPサーバーを使用するClaudeデスクトップの設定:

Claudeデスクトップ設定ファイルを編集します。

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

次の設定を追加します。

4。 Claudeデスクトップを再起動して、新しい設定をロードします。

使用例

Claude Desktopに接続すると、以下のような質問ができます。

• "nmapで192.168.1.1をスキャンして、ポートを開くことはできますか?
• 「192.168.1.1でどのようなサービスが行われているのか」
• 「http://example.com"に隠されたディレクトリを見つけるためにゴブスターを使用する]

注意

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.