Findfiles

🚀 File Search Tool

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

🚀 Quick Start

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

• directories: An array of directory paths to start the search from.
• filename: The file name or wildcard pattern to search for.
• extension: The file extension to search for.
• minSize: The minimum file size in bytes.
• maxSize: The maximum file size in bytes.
• createdAfter: Find files created after this date (format: YYYY-MM-DD).
• createdBefore: Find files created before this date (format: YYYY-MM-DD).
• modifiedAfter: Find files modified after this date (format: YYYY-MM-DD).
• modifiedBefore: Find files modified before this date (format: YYYY-MM-DD).
• recursive: Whether to recursively search subdirectories, default is true.
• caseSensitive: Whether the file name matching is case-sensitive, default is false.
• contentSearch: The text to search for in the content of text files.
• fileType: Filter by file type (text, image, audio, video, application).
• maxResults: The maximum number of results to return, default is 1000.
• timeoutMs: The maximum time limit for the search in milliseconds, default is 30000.

✨ Features

• Multi-directory Search: Search from multiple starting directories simultaneously.
• Wildcard Patterns: Search for file names using patterns like *.txt, file*, *test*.
• File Attribute Filtering: Filter by size, creation date, and modification date.
• Content Search: Support searching in the content of text files.
• File Type Filtering: Filter by file type (text, image, audio, video, application).
• Case-sensitive Option: Configure whether file name matching is case-sensitive.
• Recursive Search: Option to search subdirectories, default is true.
• Search Limits: Set the maximum number of results and time limit, default number of results is 1000, timeout is 30 seconds.

📦 Installation

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