file-finder-mcp

Integrations

  • Allows searching and retrieving files and their metadata (name, path, size, creation date) from the filesystem using path fragments.

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

A MCP server that allows searching for files in the filesystem based on path fragments, returning file metadata including name, path, size, and creation date.

  1. Components
    1. Resources
    2. Tools
  2. Quickstart
    1. Install
  3. Testing
    ID: ylzwo0zfry