Aflpp MCP

🚀 AFL++ MCP 服務器

AFL++ 的模型上下文協議（MCP）服務器。

本倉庫包含一個 AFLplusplus 的檢出副本（如果需要 AFL++ 可選模式子模塊，請使用 git submodule update --init --recursive），併為以下操作提供了便於代理使用的 API：

• 創建模糊測試工作區
• 對目標進行插樁
• 語料庫導入/最小化
• 測試 harness 預檢（試運行 / 顯示映射）
• 啟動/停止 AFL++ 作業
• 輪詢結構化狀態並對發現的問題進行分類
• 其他操作

📦 安裝指南

構建

npm install
npm run build

在 Codex CLI 中安裝

先進行構建，然後將 MCP 服務器註冊到 Codex CLI 中：

codex mcp add aflpp --env AFLPP_MCP_ROOT="$PWD" -- node "$PWD/dist/index.js"

通過標準輸入輸出運行

node dist/index.js

環境變量

• AFLPP_MCP_ROOT（默認值：當前工作目錄）
• AFLPP_DIR（默認值：$AFLPP_MCP_ROOT/AFLplusplus） – 必須位於 AFLPP_MCP_ROOT 內部

其他 MCP 客戶端配置

Claude Desktop

添加到你的 mcpServers 配置中（調整路徑）：

{
  "mcpServers": {
    "aflpp": {
      "command": "node",
      "args": ["/home/kevinv/aflpp-mcp/dist/index.js"],
      "env": {
        "AFLPP_MCP_ROOT": "/home/kevinv/aflpp-mcp"
      }
    }
  }
}

💻 使用示例

MCP 提示

• aflpp-agent-workflow：高級端到端工作流（構建 -> 語料庫 -> 預檢 -> 模糊測試 -> 分類）。
• aflpp-harness-workplan：以 harness 為先的工作流（用法 -> LLVMFuzzerTestOneInput harness -> 初始語料庫 -> CMPLOG/ASAN/普通構建 -> 啟動命令）。

MCP 資源

• aflpp://config：服務器配置（工作區根目錄、限制、允許列表）。
• aflpp://docs/quickstart：一些工作流說明。
• aflpp://docs/fuzzing_in_depth：AFL++ 的 fuzzing_in_depth.md
• aflpp://docs/cmplog：AFL++ 的 instrumentation/README.cmplog.md
• aflpp://docs/env_variables：AFL++ 的 docs/env_variables.md
• aflpp://workspace/{name}/tree：高級工作區樹
• aflpp://job/{job_name}/latest_status：作業的最新解析狀態快照
• aflpp://campaign/{campaign_name}/latest_status：活動的最新解析狀態快照

MCP 工具

• aflpp.list_tools：列出 AFL++ MCP 工具及其簡短描述。
• aflpp.help：獲取工具的詳細幫助（模式 + 描述）。
• aflpp.version：獲取 AFL++ 和服務器的版本信息。
• aflpp.init_workspace：在 workspaces/<name> 下創建一個工作區，包含用於輸入、輸出、目標、日誌、重現和報告的標準子目錄。
• aflpp.detect_build_system：檢測項目路徑可能使用的構建系統（啟發式方法）。
• aflpp.build_instrumented：使用 AFL++ 編譯器包裝器（以及可選的 sanitizer 配置文件 + 構建時旋鈕）構建目標，並將工件存儲在工作區的 targets/ 目錄下。
• aflpp.build_cmplog_variant：構建一個 CMPLOG 插樁的變體（AFL_LLVM_CMPLOG=1），並將工件存儲在工作區的 targets/ 目錄下。
• aflpp.import_corpus：從文件或目錄導入種子語料庫到 workspaces/<ws>/in/<corpus_name>。
• aflpp.list_corpus：總結語料庫目錄（文件數量和總大小）。
• aflpp.list_builtin_dictionaries：列出 AFLplusplus/dictionaries 中附帶的 AFL++ 內置字典。
• aflpp.attach_dictionary：將字典文件附加到作業名稱（存儲為作業配置，供 aflpp.start_fuzz 使用）。
• aflpp.dry_run：直接針對目標運行簡短的 harness 驗證（不是 afl-fuzz），以檢查輸入模式、穩定性、超時和基本性能。
• aflpp.showmap：對單個測試用例運行 afl-showmap 並返回跟蹤摘要。
• aflpp.coverage_summary：使用 afl-showmap -C 在 AFL++ 輸出目錄上測量語料庫覆蓋率（盡力解析）。
• aflpp.analyze_testcase：在測試用例上運行 afl-analyze 以識別關鍵輸入區域。
• aflpp.preflight_checks：在啟動 afl-fuzz 之前運行輕量級預檢檢查（核心模式、CPU 縮放、語料庫非空）。
• aflpp.start_fuzz：在工作區中啟動一個 afl-fuzz 作業（非阻塞；支持常見的 afl-fuzz 旋鈕 + 允許列表中的環境覆蓋）。
• aflpp.start_fuzz_cluster：啟動一個多實例 afl-fuzz 活動（主實例 + 輔助實例；支持每個實例的覆蓋）。
• aflpp.stop_fuzz：通過 PID 停止正在運行的 afl-fuzz 作業（先發送 SIGTERM 信號，再發送 SIGKILL 信號）。
• aflpp.status：通過解析 fuzzer_stats 以及隊列/崩潰/掛起計數（與上次調用的差值）獲取作業狀態。
• aflpp.campaign_summary：通過解析每個實例目錄的 fuzzer_stats 總結多實例活動。
• aflpp.whatsup：在 AFL++ 輸出目錄上運行 afl-whatsup。
• aflpp.generate_progress_plot：為作業或活動生成 AFL++ 進度圖（包裝 afl-plot）。
• aflpp.list_findings：列出具有穩定 ID 和路徑的崩潰和掛起發現。
• aflpp.repro_crash：通過直接使用測試用例運行目標命令來重現發現的問題，並在 repros/ 下寫入重現包。
• aflpp.crash_report：為發現的問題編寫崩潰報告（去重簽名 + 重現信息 + 如果存在則包含 sanitizer 幀）。
• aflpp.casr_report：使用 casr-afl 生成聚類崩潰報告（如果已安裝）。
• aflpp.minimize_corpus：使用 afl-cmin 最小化語料庫，並將其存儲為工作區中的新語料庫目錄。
• aflpp.minimize_testcase：使用 afl-tmin 最小化單個測試用例，並將最小化後的測試用例存儲在 repros/ 下。
• aflpp.suggest_fuzz_cluster_mix：為 aflpp.start_fuzz_cluster 建議多核活動組合（instance_overrides）。