Kali Docker MCP

🚀 Kali MCP Server

Kali MCP Serverは、コンテナ化されたKali Linux環境でコマンド実行機能を提供するModel Context Protocol (MCP)サーバーです。半自動化された侵入テストやセキュリティ研究機能を実現します。

🎥 デモ

https://github.com/user-attachments/assets/demo.mp4

Kali MCP Serverの動作をご覧ください

⚠️ 免責事項

このツールは、教育目的および許可されたセキュリティテスト目的のみに提供されています。自己責任で使用してください。著者は、このソフトウェアによる誤用や損害について一切の責任を負いません。セキュリティ評価を行う前に、常に適切な許可を取得してください。

✨ 主な機能

• コンテナ化されたコマンド実行：コンテナ化された環境でKali Linuxのセキュリティツールを実行します。
• バックグラウンドジョブ管理：長時間実行されるコマンド（>60秒）は自動的にバックグラウンドジョブとして実行されます。
• Interactsh統合：ブラインド脆弱性の帯域外相互作用検出を行います。
• サービスAPI管理：調査用API（GitHub、Shodanなど）の集中的な構成を行います。
• ワークスペース管理：侵入テストの成果物を整理したディレクトリ構造を提供します。

📋 必要条件

• DockerとDocker Compose
• MCP互換クライアント（Claude Code、Gemini CLI、Copilot付きのVS Codeなど）

🚀 クイックスタート

1. コンテナを起動する：

   docker compose up --build -d
   

2. コンテナが実行中であることを確認する：

   docker ps | grep kali-mcp-server
   

3. MCPクライアントを設定する：

   ⚠️ 重要: MCPクライアントの組み込みターミナルやコマンド実行ツールを無効にして、コマンドがホストシステムではなくKaliコンテナ内で実行されるようにしてください。すべてのセキュリティツールは、安全と分離のためにコンテナ化された環境内でのみ実行する必要があります。

Claude Desktop:

claude mcp add --transport stdio kali-mcp-server "docker exec -i kali-mcp-server python3 /app/kali_server.py"

Gemini CLI:

gemini mcp add kali-mcp-server "docker exec -i kali-mcp-server python3 /app/kali_server.py"

VS Code (Copilot):

ワークスペース内の.vscode/mcp.jsonを作成または編集します：

{
  "servers": {
    "kali-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "kali-mcp-server",
        "python3",
        "/app/kali_server.py"
      ]
    }
  }
}

その他

{
   "mcpServers": {
      "kali-mcp-server": {
         "type": "stdio",
         "command": "docker",
         "args": [
            "exec",
            "-i",
            "kali-mcp-server",
            "python3",
            "/app/kali_server.py"
            ],
         "env": {}
      }
   }
}

設定後：MCPクライアントを再起動して、Kali MCPサーバーを読み込みます。

💻 使用例

利用可能なツール

コアMCPツール

• run_kali_command - Kali環境でコマンドを実行します。
• get_job_status - バックグラウンドジョブの状態を確認します。
• list_background_jobs - すべての実行中のジョブを一覧表示します。
• cancel_job - 実行中のジョブをキャンセルします。
• get_workspace_info - ワークスペースの構成を取得します。

Interactshツール

• start_interactsh - 帯域外相互作用監視を開始します。
• get_interactsh_status - Interactshワーカーの状態を確認します。
• poll_interactsh - 記録された相互作用を取得します。
• stop_interactsh - Interactshワーカーを停止します。

サービス管理

• get_service_tokens - 構成されたAPIサービストークンを取得します。

事前インストールされたセキュリティツール

• ネットワークスキャン：nmap、masscan
• Webテスト：dirb、ffuf、whatweb、nikto
• DNS/ドメイン：dig、whois、dnsrecon
• ユーティリティ：curl、wget、jq、exiftool
• ワードリスト：Seclists

⚙️ 設定

config.tomlを編集して以下を設定します：

• ワークスペースのディレクトリ構造
• Interactshの設定
• APIサービストークン（GitHub、Shodan、VirusTotalなど）

🔒 セキュリティに関する注意事項

• コンテナはセキュリティツールに必要な特権で実行されます。
• ネットワークツールには拡張された機能（NET_ADMIN、NET_RAW）が必要です。
• すべてのコマンド実行はDocker環境内に制限されます。
• 本番環境ではAPIトークンを安全に構成する必要があります。

📄 ライセンス

このプロジェクトは独立したオープンソースの貢献であり、OffSecやKali Linuxとは関係がなく、承認もされておらず、関連付けもされていません。Kali LinuxはOffensive Securityの商標です。