Findfiles

🚀 文件查找工具

這是一個高級的文件搜索工具，能讓用戶藉助各類過濾選項，在計算機上高效搜索文件，極大提升文件查找效率。

🚀 快速開始

此工具作為 MCP（模型上下文協議）服務器實現，使用時需瞭解以下支持的參數：

• directories：數組形式的目錄路徑，從這些路徑開始搜索
• filename：要搜索的文件名或通配符模式
• extension：要搜索的文件擴展名
• minSize：文件大小的最小值（以字節為單位）
• maxSize：文件大小的最大值（以字節為單位）
• createdAfter：查找創建時間在此日期之後的文件（格式：YYYY - MM - DD）
• createdBefore：查找創建時間在此日期之前的文件（格式：YYYY - MM - DD）
• modifiedAfter：查找修改時間在此日期之後的文件（格式：YYYY - MM - DD）
• modifiedBefore：查找修改時間在此日期之前的文件（格式：YYYY - MM - DD）
• recursive：是否有選項遞歸搜索子目錄，默認為 true
• caseSensitive：文件名匹配是否區分大小寫，默認為 false
• contentSearch：在文本文件內容中搜索的文本
• fileType：按文件類型篩選（文本、圖像、音頻、視頻、應用程序）
• maxResults：要返回的最大結果數，默認為 1000
• timeoutMs：搜索的最大時間限制，以毫秒為單位，默認為 30000

✨ 主要特性

• 多目錄搜索：可同時從多個起始目錄進行搜索，擴大搜索範圍。
• 通配符模式：支持使用類似 *.txt、file*、*test* 的模式搜索文件名，靈活定位文件。
• 文件屬性過濾：能按大小、創建日期和修改日期篩選文件，精準查找所需文件。
• 內容搜索：支持在文本文件的內容中搜索，滿足更細緻的查找需求。
• 文件類型過濾：可按文件類型（如文本、圖像、音頻、視頻、應用程序）篩選，提高查找效率。
• 大小寫敏感選項：可配置文件名匹配是否區分大小寫，適應不同的搜索場景。
• 遞歸搜索：有選項搜索子目錄，默認開啟，確保搜索全面。
• 搜索限制：可設置結果的最大數量和時間限制，默認結果數為 1000，超時時間為 30 秒，避免無限制搜索。

📦 安裝指南

以下是安裝的配置示例：

{
    "mcpServers": {
        "find-files": {
            "command": "npx",
            "args": [
                "-y",
                "find-files-mcp",
                "/Users/kst/Downloads", // 下載目錄
                "/Users/kst/Desktop",   // 桌面目錄
                "/Users/kst/Documents"  // 文檔目錄
            ]
        }
    }
}