Skip to main content
Glama
Sign In
deenesjakoruzh

Claude Kali MCP Commander

by house-of-stark
GitHub
JavaScript
2
  • Linux
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides secure access to Kali Linux penetration testing tools directly through Claude's interface, allowing users to run security tools in an isolated Docker container.

クロード・カリ MCP 統合

Claude Desktop 向けの Kali Linux MCP（Model Context Protocol）統合のクリーンで最小限の実装。Claude インターフェースを介して Kali Linux ツールへの安全なアクセスを提供します。このプロジェクトにより、分離された Docker コンテナ内でセキュリティツールとコマンドをシームレスに実行できるようになります。

特徴

  • 🐳 Dockerベース- 一貫した実行のためのコンテナ化された環境
  • 🔒隔離された環境- 安全なサンドボックス内の Kali Linux ツール
  • 🔄自動ヘルスチェック- サービスの信頼性と可用性を確保
  • 📡 MCP サーバー- Claude Desktop との標準プロトコル統合
  • 🚀クイックセットアップ- 最小限の設定で始めましょう
  • 🔧設定可能- カスタマイズ可能なポートと設定
  • 🔍セキュリティファースト- セキュリティツールのための分離された実行環境
  • 📊モニタリング- ヘルスチェックとステータスエンドポイントが組み込まれています

前提条件

ネットワーキングノート

デフォルトでは、提供されているdocker-compose.ymlファイルとdocker-compose.full.ymlファイルはホストネットワーク（ network_mode: host ）を使用します。これにより、コンテナはホストネットワークへのフルアクセスが可能になります。これは、一部の高度なネットワークツールやシナリオで必要となります。

セキュリティに関する注意:

  • ホストネットワークでは、ホストとコンテナ間の分離性が低くなります。すべてのネットワークインターフェースとポートは共有されます。
  • より高度な分離を希望する場合は、 network_mode: host行を削除し、関連するサービスにports:マッピング（例： 8081:8080 ）を追加することで、Docker のデフォルトのbridgeネットワークに切り替えることができます。詳細については、compose ファイル内のコメント付きの例と以下のドキュメントを参照してください。

クイックスタート

  1. リポジトリをクローンします:
    git clone https://github.com/house-of-stark/Claude-Kali-MCP-Commander cd Claude-Kali-MCP-Commander

🛠️ ビルドと実行手順

注: Kaliコンテナ内では、 nmapなどの昇格権限を必要とするツールのためにsudoが有効になっています。sudo sudo使用を制限したい場合は、 config.jsonのblockedCommandsリストを編集してください。

Windows (PowerShell)

**注:**スクリプトの署名または実行ポリシー エラーが発生した場合は、ExecutionPolicy Bypass を使用してスクリプトを実行します。

  1. 最小ビルド（推奨）:
    powershell -ExecutionPolicy Bypass -File .\build.ps1 docker-compose up -d
  2. 完全な Kali ツールビルド:
    powershell -ExecutionPolicy Bypass -File .\build.ps1 -Profile full docker-compose -f docker-compose.full.yml up -d

Linux / macOS (Bash)

  1. 最小ビルド（推奨）:
    ./build.sh minimal docker-compose up -d
  2. 完全な Kali ツールビルド:
    ./build.sh full docker-compose -f docker-compose.full.yml up -d

サービスの開始と監視

  • クイックスタートスクリプト (Linux/macOS):
    chmod +x start.sh ./start.sh
    これにより、コンテナがビルドおよび起動され、準備完了まで待機し、ステータスが表示されます。
  • ヘルスエンドポイントを確認します:
    curl http://localhost:8080/health
    返される値: {"status":"ok"}
  • 実行中のコンテナを表示します。
    docker ps --filter "name=kali-mcp-commander"

Claudeデスクトップの設定

  • MCP サーバーの URL を次のように設定します: http://localhost:8080
  • (オプション) プロジェクトパスをローカルリポジトリディレクトリに設定する
  1. ビルドプロファイルを選択してください:
    • 最小（デフォルト） ：MCP サーバーのみの小さな画像（ほとんどのユーザーに推奨）
      ./build.sh minimal docker-compose up -d
    • フル: すべてのツールを備えた完全な Kali Linux (非常に大きな画像)
      ./build.sh full docker-compose -f docker-compose.full.yml up -d

    最小ビルドははるかに高速でサイズも小さく、フルビルドにはすべての Kali Linux ツールが含まれますが、かなりのディスク容量が必要になります。

  2. インストールを確認します:
    curl http://localhost:8081/health
    返される値: {"status":"ok"}
  3. Claude デスクトップを構成する:
    • Claudeデスクトップの設定を開く
    • MCP サーバーの URL を次のように設定します: http://localhost:8081
    • プロジェクトパスをこのリポジトリのフルパスに設定します（例： /path/to/Claude-Kali-MCP-Commander ）
    • Claudeデスクトップを再起動します

プロジェクト構造

. ├── .gitignore # Git ignore file ├── CONTRIBUTING.md # Contribution guidelines ├── Dockerfile # Kali Linux container setup with MCP server ├── LICENSE # MIT License ├── README.md # This file ├── config/ # Configuration files │ └── claude_desktop_config.json # Claude Desktop configuration ├── docker-compose.yml # Service definitions and orchestration ├── health-server.js # Health check server implementation ├── package.json # Node.js dependencies └── start.sh # Helper script to start services

統合のテスト

サービスを開始したら、MCP 統合をテストできます。

  1. 基本的なヘルスチェック: (Docker へのブリッジを使用している場合)
    curl http://localhost:8081/health
    返される値: {"status":"ok"}
  2. コンテナのステータスを確認します:
    docker ps --filter "name=kali-mcp-commander-minimal"
    コンテナが「正常」であると表示されるはずです
  3. コンテナログの表示:
    docker logs kali-mcp-commander
    エラーメッセージや警告がないか確認する

構成

クロードデスクトップ構成

この MCP サーバーを Claude Desktop で使用するには、Claude Desktop 設定で以下を構成する必要があります。

  1. Kali Linux MCP（必須） ：Kali Linuxツールを使用してDockerコンテナ内でコマンドを実行します。
  2. ホストOSコマンダー（オプション） : Claude DesktopがインストールされているホストOS上で直接コマンドを実行するために使用できます。Kali Linux環境のみが必要な場合は、このセクションを削除できます。

単一の MCP サーバーの例claude_desktop_config.json :

{ "mcpServers": { "kali-mcp": { "command": "docker", "args": [ "exec", "-i", "kali-mcp-commander-minimal", "npx", "@wonderwhy-er/desktop-commander" ], "name": "Kali Linux MCP", "description": "Access Kali Linux security tools via MCP" } }, "defaultMcpServerId": "kali-mcp" }

MCP Commander デスクトップ OS と Kali MCP サーバーの例claude_desktop_config.json :

{ "mcpServers": { "kali-mcp": { "command": "docker", "args": [ "exec", "-i", "kali-mcp-commander-minimal", "npx", "@wonderwhy-er/desktop-commander" ], "name": "Kali Linux MCP", "description": "Access Kali Linux security tools via MCP" }, "desktop-commander": { "command": "npx", "args": [ "@wonderwhy-er/desktop-commander@latest" ], "name": "Host OS Commander", "description": "Access commands on the host OS where Claude Desktop is installed" } }, "defaultMcpServerId": "kali-mcp" }

環境変数

docker-compose.ymlファイルで次の環境変数をカスタマイズできます。

  • MCP_SERVER_PORT : MCPサーバーのポート（デフォルト: 8080）
  • NODE_ENV : 環境モード（開発/本番）
  • LOG_LEVEL : ログの詳細度（デバッグ、情報、警告、エラー）

ポート構成（ホストネットワークを使用しない場合）

デフォルトのポートを変更するには、 docker-compose.ymlのportsセクションを変更します。

ports: - "8081:8080" # HostPort:ContainerPort

トラブルシューティング

よくある問題

  1. ポート競合
    • 症状: ポートバインディングエラーによりコンテナの起動に失敗する
    • 解決策: docker-compose.ymlのホストポートを変更する
  2. コンテナのヘルスチェックが失敗する
    • 症状: コンテナが継続的に再起動する
    • 解決策: docker logs kali-mcp-commander-minimalでログを確認する
  3. MCP サーバーが応答しません
    • 症状: Claude Desktop が MCP サーバーに接続できない
    • 解決：
      • サーバーが実行中であることを確認します: curl http://localhost:8081/health
      • Dockerのネットワーク設定を確認する
      • ファイアウォールがポート8081をブロックしていないことを確認する

デバッグ

詳細なデバッグを行うには、 docker-compose.yml変更して追加のログを含めることができます。

environment: - NODE_ENV=development - DEBUG=*

セキュリティに関する考慮事項

  • コンテナは最小限の権限で実行される
  • ネットワークアクセスはデフォルトでローカルホストに制限されています
  • ベースとなるKali Linuxイメージには定期的なセキュリティアップデートが推奨されます。
  • Dockerfileでカスタム構成を確認する

パフォーマンス

  • コンテナはリソースの使用を最小限に抑えるように最適化されています
  • ヘルスチェックによりサービスの可用性を確保
  • リソース制限はdocker-compose.ymlで設定できます。

貢献

貢献を歓迎します！このプロジェクトへの貢献方法の詳細については、貢献ガイドラインをお読みください。

貢献する際は、次の点にご注意ください。

  1. リポジトリをフォークする
  2. 機能ブランチを作成する
  3. 変更をコミットする
  4. ブランチにプッシュする
  5. 新しいプルリクエストを作成する

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

著作権 (c) 2025 Chris Stark。Chris Starkが管理。

クレジット

サポート

サポートについては、GitHub で問題を開いてください。

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Claude のインターフェースを通じて Kali Linux サイバーセキュリティ ツールへの安全なアクセスを提供し、ユーザーが Claude Desktop から直接 Kali Linux コマンドを実行できるようにする MCP サーバー。

  1. 特徴
    1. 前提条件
      1. ネットワーキングノート
        1. クイックスタート
          1. 🛠️ ビルドと実行手順
            1. Windows (PowerShell)
            2. Linux / macOS (Bash)
            3. サービスの開始と監視
            4. Claudeデスクトップの設定
          2. プロジェクト構造
            1. 統合のテスト
              1. 構成
                1. クロードデスクトップ構成
                2. 環境変数
                3. ポート構成（ホストネットワークを使用しない場合）
              2. トラブルシューティング
                1. よくある問題
                2. デバッグ
              3. セキュリティに関する考慮事項
                1. パフォーマンス
                  1. 貢献
                    1. ライセンス
                      1. クレジット
                        1. サポート

                          Related MCP Servers

                          • mcp-server-commands

                            g0t4
                            A
                            security
                            A
                            license
                            A
                            quality
                            An MCP server to run commands.
                            Last updated -
                            2
                            556
                            133
                            TypeScript
                            MIT License
                            • Apple

                          • mcp-wsl-exec

                            spences10
                            A
                            security
                            A
                            license
                            A
                            quality
                            A secure MCP server for Windows Subsystem for Linux environments, facilitating safe command execution with extensive validation and protection against vulnerabilities like shell injection and dangerous commands.
                            Last updated -
                            2
                            24
                            9
                            JavaScript
                            MIT License

                          • Super Shell MCP Server

                            cfdude
                            -
                            security
                            A
                            license
                            -
                            quality
                            An MCP server that enables secure execution of shell commands across Windows, macOS, and Linux with built-in whitelisting and approval mechanisms for enhanced security.
                            Last updated -
                            13
                            JavaScript
                            MIT License
                            • Linux
                            • Apple

                          • Kali Linux MCP Server

                            sfz009900
                            A
                            security
                            F
                            license
                            A
                            quality
                            A tool that allows penetration testing through Kali Linux commands executed via a Multi-Conversation Protocol server, supporting security testing operations like SQL injection and command execution.
                            Last updated -
                            5
                            5
                            TypeScript

                          View all related MCP servers

                          New MCP Servers

                          ID: gf1wuhlxzi