Mcp Pymetasploit3

io.github.daedalus由 GitHub 帳號 daedalus 發布v0.1.1更新於 Oct 24, 2026

MCP server for Metasploit Framework via pymetasploit3

已驗證STDIO僅桌面開發者工具安全與監控

概覽

AI 產生的概覽

本機 MCP 伺服器,透過 msfrpc 暴露 Metasploit Framework,讓助理列出、設定、執行與管理模組、載荷、工作階段及框架狀態。

可以做什麼
連線與中斷 Metasploit RPC 伺服器,查看連線狀態、框架版本、核心狀態、全域變數、工作與外掛。搜尋、列出、載入與檢視模組,設定選項與目標,檢查缺少的必填項並執行模組。產生載荷,列出相容的目標與載荷。列出、檢視、互動、在工作階段中執行指令並停止工作階段。建立、寫入、讀取與銷毀主控台,執行模組並取得輸出。查詢資料庫中的工作區、主機、服務、筆記、憑證與弱點。
適用情境
適用於取得授權的安全測試、實驗環境或 CTF 情境,讓助理透過 RPC 介面驅動既有的 Metasploit Framework 實例,而不必手動輸入 msfconsole 指令。不適用於一般開發或非安全任務。
執行需求
以 pip 安裝的 Python 套件在本機執行,僅限桌面端。需要執行中的 Metasploit Framework RPC 伺服器(msfrpcd 或 msfconsole 中的 msgrpc),提供主機與連接埠,並向 connect 工具提供 RPC 密碼。未宣告環境變數或標頭。
安裝前請注意
這會讓助理控制一個攻擊性安全框架:執行模組、產生載荷、在工作階段中執行指令與變更框架狀態都可能影響真實系統,僅限在取得授權測試的系統上使用。RPC 密碼需傳給 connect 工具,必須妥善保護。資料庫工具可讀取已儲存的憑證與弱點資料。載入外掛與執行模組可能在目標上執行任意程式碼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Pymetasploit3,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mcp-pymetasploit3

MCP server for Metasploit Framework via pymetasploit3. This server exposes all pymetasploit3 functionality as MCP tools, allowing LLMs to interact with Metasploit Framework through the msfrpc protocol.

[PyPI] [Python]

Install

bash
pip install mcp-pymetasploit3

MCP Server Configuration

json
{  "mcpServers": {    "mcp-pymetasploit3": {      "command": "mcp-pymetasploit3",      "env": {}    }  }}

Usage

Starting Metasploit RPC Server

Before using the MCP server, you need to start the Metasploit RPC server:

Using msfrpcd:

bash
msfrpcd -P yourpassword -p 55553 -n

Using msfconsole:

bash
msfconsole -qmsf6 > load msgrpc Pass=yourpassword

MCP Tools

Once connected, the following tools are available:

Connection Management
  • connect - Connect to Metasploit RPC server
  • disconnect - Disconnect from RPC server
  • get_client_info - Get current connection status
Module Management
  • list_modules - List available modules by type
  • use_module - Load a specific module
  • get_module_info - Get module description and info
  • get_module_options - Get all module options
  • set_module_option - Set a module option
  • get_missing_required - Get required options not set
  • execute_module - Execute a module
  • get_module_targets - Get available targets
  • set_module_target - Set the target
  • get_target_payloads - Get compatible payloads
Payload Generation
  • generate_payload - Generate a payload
Session Management
  • list_sessions - List all active sessions
  • get_session_info - Get session information
  • interact_session - Write/read from session
  • session_run_command - Run command with output
  • stop_session - Stop a session
Console Management
  • create_console - Create a new console
  • destroy_console - Destroy a console
  • write_console - Write to console
  • read_console - Read console output
  • console_is_busy - Check if console is busy
  • run_module_output - Execute module and get output
Core/Framework
  • get_framework_version - Get framework version
  • core_save - Save core state
  • core_reload_modules - Reload modules
  • core_set_global - Set global variable
  • core_unset_global - Unset global variable
Database
  • get_db_status - Get database status
  • db_list_workspaces - List workspaces
  • db_set_workspace - Set current workspace
  • db_list_hosts - List hosts
  • db_list_services - List services
  • db_list_notes - List notes
  • db_list_creds - List credentials
  • db_list_vulns - List vulnerabilities
Jobs
  • list_jobs - List running jobs
  • stop_job - Stop a job
  • get_job_info - Get job information
Plugins
  • list_plugins - List loaded plugins
  • load_plugin - Load a plugin
  • unload_plugin - Unload a plugin
Search
  • search_modules - Search for modules
  • get_module_references - Get module references

Example

python
# Connect to Metasploitconnect(password="yourpassword", host="127.0.0.1", port=55553, ssl=False)
# List exploitsexploits = list_modules("exploit")
# Use an exploituse_module("exploit", "unix/ftp/vsftpd_234_backdoor")
# Set optionsset_module_option("exploit", "unix/ftp/vsftpd_234_backdoor", "RHOSTS", "192.168.1.100")
# Executeresult = execute_module("exploit", "unix/ftp/vsftpd_234_backdoor", payload="cmd/unix/interact")
# List sessionssessions = list_sessions()
# Interact with sessionoutput = interact_session("1", "whoami")
# Disconnectdisconnect()

Development

bash
git clone https://github.com/daedalus/mcp-pymetasploit3.gitcd mcp-pymetasploit3pip install -e ".[test]"
# run testspytest
# formatruff format src/ tests/
# lintruff check src/ tests/
# type checkmypy src/

mcp-name: io.github.daedalus/mcp-pymetasploit3

來源:README.md,提交 295f8aa

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分