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"  // 文档目录
            ]
        }
    }
}