find-files-mcp

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"
            ]
        }
    }
}