Vibehacker Metasploit MCP

🚀 Vibehacker Metasploit MCP

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=127.0.0.1
export MSF_PORT=55553

运行应用程序

python main.py

或运行测试工具：

mcp dev main.py

✨ 主要特性

• 列出可用的 Metasploit 攻击模块
• 列出可用的有效负载
• 生成有效负载
• 对目标运行攻击模块
• 扫描目标
• 管理活动会话
• 向会话发送命令

📄 许可证

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