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

Serveurs connexes

NotebookLM Web Importer

Importez des pages web et des vidéos YouTube dans NotebookLM en un clic. Utilisé par plus de 200 000 utilisateurs.

Installer l'extension Chrome