Vibehacker Metasploit MCP

一个基于 FastMCP 的 Metasploit Framework 接口，使 AI 代理能够与 Metasploit 功能进行交互。

前提条件

• Python 3.10+
• Metasploit Framework
• uv (Python 包管理器)

使用 uv 设置

本项目使用 uv 进行依赖管理。 uv 是一个快速、可靠的 Python 包安装程序和解析器。

安装 uv

如果您尚未安装 uv：

pip install uv

设置项目

1. 克隆存储库：

git clone https://github.com/foolsec/vibehacker_metasploit_mcp.git
cd vibehacker_metasploit_mcp

2. 使用 uv 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # 在 Windows 上： .venv\Scripts\activate

3. 安装依赖项：

uv pip install -e .

运行 Metasploit RPC 服务器

在运行应用程序之前，启动 Metasploit RPC 服务器：

# 完整配置，包含所有选项
msfrpcd -P kalipassword -S -a 127.0.0.1 -p 55553

或者使用更简单的命令在默认端口 (55553) 上于后台启动 RPC 服务器：

msfrpcd -P your_password

环境变量

设置以下环境变量：

export MSF_PASSWORD=kalipassword
export MSF_SERVER=127.0.0.1
export MSF_PORT=55553

运行应用程序

python main.py

或者测试工具

mcp dev main.py

功能

• 列出可用的 Metasploit 漏洞利用
• 列出可用的有效载荷
• 生成有效载荷
• 针对目标运行漏洞利用
• 扫描目标
• 管理活动会话
• 向会话发送命令

许可证

有关详细信息，请参阅 LICENSE 文件。