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