file-finder-mcp MCP Server

A MCP server for searching files in the filesystem based on a path fragment.

Components

Resources

The server implements a file search system:

• Each file resource includes:
  • File name
  • Full path
  • File size
  • Creation date

Tools

The server provides one tool:

• search-files: Searches for files matching a given path fragment.
  • Takes query as a required string argument.
  • Takes directory as an optional string argument to specify the base directory for the search. If not provided, the search runs in the root directory.
  • Returns a list of matching files with their metadata.

Testing

The testing was conducted using the Gemini model with the following prompt:

hi can you find files called file_to_find on my desktop using my mcp server

Quickstart

Install

Replace the contents of the cline_mcp_settings.json file with the following configuration:

{
  "mcpServers": {
    "file-finder-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/stleubaev/Desktop/ClineTest/file-finder-mcp",
        "run",
        "file-finder-mcp"
      ]
    }
  }
}