What is Find Files Mcp

FindFiles is an advanced file search tool designed to help users efficiently locate files on their computer by using a variety of searching and filtering options. It streamlines the file retrieval process by allowing for complex queries based on file names, attributes, and contents.

Use cases

This tool can be used by individuals or organizations needing to quickly find specific files across multiple directories. Typical scenarios include data recovery, organization of files, locating documents based on specific criteria, or analyzing content within files.

How to use

To utilize FindFiles, users must specify a set of parameters such as directories to search, filename patterns, file types, size restrictions, and date filters through an MCP server. The parameters can be adjusted according to the search needs, and results can be limited in number and time.

Key features

Key features include multi-directory searching, wildcard filename patterns, filtering by various file attributes (size, creation, modification dates), recursive searching, case sensitivity options, content searching within text files, and a cap on the number of results and search duration.

Where to use

FindFiles is suitable for use on personal computers, in office environments, or in any scenario where file management is necessary. It can be deployed in various development or administrative tasks that require efficient file searching capabilities.

FindFiles

An advanced file search tool that allows users to search for files on their computer using various filtering options.

Key Features

• Multi-directory Search: Search simultaneously from multiple starting directories
• Wildcard Patterns: Search for filenames using patterns like *.txt, file*, *test*
• File Attribute Filtering: Filter by size, creation date, and modification date
• Content Search: Support for searching within text file contents
• File Type Filtering: Filter by file types such as text, image, audio, video, application
• Case Sensitivity Option: Configure whether filename matching is case-sensitive
• Recursive Search: Option to search subdirectories
• Search Limitations: Set maximum number of results and time limits

Usage

This tool is implemented as an MCP (Model Context Protocol) server and supports the following parameters:

• directories: Array of directory paths to start the search from
• filename: File name or wildcard pattern to search for
• extension: File extension to search for
• minSize: Minimum file size (in bytes)
• maxSize: Maximum file size (in bytes)
• createdAfter: Search for files created after this date (YYYY-MM-DD format)
• createdBefore: Search for files created before this date (YYYY-MM-DD format)
• modifiedAfter: Search for files modified after this date (YYYY-MM-DD format)
• modifiedBefore: Search for files modified before this date (YYYY-MM-DD format)
• recursive: Whether to search subdirectories recursively (default: true)
• caseSensitive: Whether filename matching should be case-sensitive (default: false)
• contentSearch: Text to search for within file contents (text files only)
• fileType: Filter by file type (text, image, audio, video, application)
• maxResults: Maximum number of results to return (default: 1000)
• timeoutMs: Maximum search time in milliseconds before timeout (default: 30000)

Installation

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