文件搜索工具

一款高级文件搜索工具,支持多目录搜索、文件属性过滤、内容搜索等多种功能,适用于本地文件管理。

  • by thuhoai27
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 thuhoai27/find-files-mcp

使用说明

查找文件

一种高级文件搜索工具,允许用户使用各种过滤选项在计算机上搜索文件。

主要特点

  • 多目录搜索:从多个起始目录同时搜索
  • 通配符模式:使用以下模式搜索文件名 *.txt, file*, *test*
  • 文件属性筛选:按大小、创建日期和修改日期筛选
  • 内容搜索:支持在文本文件内容中搜索
  • 文件类型筛选:按文件类型过滤,如文本、图像、音频、视频、应用程序
  • 案例敏感性选项:配置文件名匹配是否区分大小写
  • 递归搜索:搜索子目录的选项
  • 搜索限制:设置最大结果数和时间限制

用法

此工具被实现为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)

安装

{
    "mcpServers": {
        "find-files": {
            "command": "npx",
            "args": [
                "-y",
                "find-files-mcp",
                "/Users/kst/Downloads",
                "/Users/kst/Desktop",
                "/Users/kst/Documents"
            ]
        }
    }
}