Vibehacker Metasploit MCP

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

预备条件

• Python 3.10+
• Metasploit框架
• 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=1172.16.17.32
export MSF_PORT=55553

运行应用程序

python main.py

或测试工具：

mcp dev main.py

功能

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

许可证

详情见LICENSE文件。 </中文翻译>