Pathscan MCP Server

🚀 使用方法

本部分將詳細介紹如何安裝和啟動MCP服務，以及如何將其集成到cline中，同時還包含故障排除和後續待辦事項等內容。

📦 安裝依賴

1. 為dirsearch安裝依賴

進入dirsearch目錄，並執行以下命令將依賴安裝在全局環境中：

pip install -r .\requirements.txt

2. 在全局環境中安裝setuptools

pip install setuptools

3. 安裝uv管理器

uv是一個極快的Python包和項目管理器，用Rust編寫。執行以下命令進行安裝：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

4. 為MCP服務安裝依賴

uv sync

🚀 本地部署AI爬蟲工具

部署firecrawl

firecrawl是一個AI爬蟲工具，包含數據清洗功能，支持本地docker部署。參考文章如下：

• https://www.cnblogs.com/skystrive/p/18893148
• https://docs.firecrawl.dev/contributing/guide

故障排除

在使用本地部署的firecrawl進行網頁爬取時，若返回Unauthorized，可將.env配置文件中的USE_DB_AUTHENTICATION字段值設為false，你也可以直接使用提供的.env文件。

測試服務是否正常運行

打開網址：http://{firecrawl server IP}:3002/test，若出現Hello, world!，則說明服務正常運行。

📝 編輯配置文件

編輯config.py文件

• FIRECRAWL_HOST：你的firecrawl運行的HOST地址。
• GLOBAL_PYTHON_PATH：你的全局Python地址，可在cmd中輸入where python獲取。

💻 啟動服務

啟動MCP服務

uv run main.py

當出現如上圖所示的日誌時，說明服務啟動成功。

在cline中添加服務

直接編輯配置文件：

{
    "mcpServers": {
        "path scanner": {
            "url": "http://127.0.0.1:8000/sse",
            "disabled": false,
            "autoApprove": [],
            "timeout": 1800
        }
    }
}

當出現如上圖所示的情況時，說明你的MCP server可以被cline使用了。

📋 掃描網站提示

你可以調用已有的MCP服務對指定網站進行掃描，並返回結構化結果（表格形式）。根據MCP掃描結果，可進行以下操作：

• 提取並總結網站所使用的技術棧。
• 根據掃描報告中的風險等級，分類整理網站的漏洞信息（高危/中危/低危）。
• 對於報告中標記為高危漏洞的相關URL，進一步讀取該URL的頁面內容，並生成內容摘要。

最終請將數據彙總為以下結構輸出：

• 技術棧
• 漏洞信息（按嚴重程度分類）
• 高危漏洞相關的URL及內容摘要
• 目標網站URL

🎨 效果展示

📅 TODO

服務端尚未初始化完成就收到了客戶端的請求，解決辦法是在正式使用服務之前對服務進行init操作。

🔗 參考

此項目靈感來自於項目ai_dirscan