File Finder

Search for files in the local filesystem using a path fragment.

GitHub

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.

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

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

Verwandte Server