Security Tools Suite

🚀 FFUF MCP 桥接工具

FFUF MCP 是连接 FFUF（更快的网络模糊测试工具）与模型上下文协议（Model Context Protocol, MCP）生态系统的桥梁，能实现二者的无缝集成，助力安全测试自动化。

🚀 快速开始

FFUF MCP 实现了 FFUF 强大的网络模糊测试功能与 MCP 兼容应用程序和人工智能驱动工作流系统的无缝集成。该桥接工具使您能够通过标准化协议访问 FFUF 功能，从而更轻松地将其纳入自动化安全测试流水线或 AI 助手功能中。

✨ 主要特性

• 完全暴露 FFUF 功能到 MCP
• 简单的配置和设置
• 与其他 MCP 兼容工具和系统的轻松集成
• 标准化输入/输出处理

📦 安装指南

先决条件

• Node.js（v16 或更高版本）
• 系统上安装了 FFUF
• MCP SDK

设置

1. 克隆此仓库：

git clone https://github.com/cyproxio/mcp-for-security
cd ffuf-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

💻 使用示例

基础用法

基本配置

在 MCP 客户端配置中配置 FFUF MCP 服务器：

{
  "ffuf": {
    "command": "node",
    "args": [
      "/path/to/ffuf-mcp/build/index.js",
      "ffuf"
    ]
  }
}

运行 FFUF 测试

配置完成后，可以通过 MCP 接口使用 do-ffuf 工具运行 FFUF 测试：

// 调用 FFUF 通过 MCP 的示例
const result = await mcp.tools.invoke("do-ffuf", {
  url: "http://example.com/FUZZ",
  ffuf_args: ["-w", "/path/to/wordlist.txt"]
});

可用选项

FFUF MCP 支持所有标准 FFUF 参数。请参阅 FFUF 文档 获取完整参数列表。

高级用法

目录模糊测试

const result = await mcp.tools.invoke("do-ffuf", {
  url: "http://target-website.com/FUZZ",
  ffuf_args: [
    "-w", "/path/to/common-directories.txt",
    "-mc", "200,204,301,302,307,401,403"
  ]
});

📚 详细文档

集成与 AI 助手

FFUF MCP 设计用于与支持模型上下文协议的 AI 助手无缝协作，使自然语言交互式安全测试任务成为可能。

AI 助手与用户之间的示例对话：

用户：模糊测试 http://example.com 的隐藏目录
AI：我将使用 FFUF 帮您进行隐藏目录的模糊测试。

[AI 使用 FFUF MCP 执行测试并返回结果]

FFUF 发现了以下目录：
- /admin（状态：301）
- /api（状态：200）
- /backup（状态：403）
...

故障排除

遇到问题时：

1. 验证 FFUF 是否正确安装且可访问
2. 检查 FFUF 可执行文件在配置中的路径是否正确
3. 确保执行权限设置正确
4. 查看服务器日志获取详细错误信息

📄 许可证

致谢

• FFUF 项目：https://github.com/ffuf/ffuf
• 模型上下文协议：https://github.com/modelcontextprotocol