Vibehacker Metasploit MCP

🚀 Vibehacker Metasploit MCP

Vibehacker Metasploit MCP 是一个基于 FastMCP 的接口，它能够连接到 Metasploit 框架，让 AI 代理可以交互使用 Metasploit 的各项功能，为安全测试和渗透工作提供便利。

🚀 快速开始

✅ 先决条件

• Python 3.10+
• Metasploit 框架
• uv（Python 包管理器）

📦 安装指南

此项目使用 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 文件。