file-finder-mcp

  • Apple

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

    Related MCP Servers

    • A
      security
      A
      license
      A
      quality
      An MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.
      Last updated -
      1
      4
      TypeScript
      MIT License
    • -
      security
      F
      license
      -
      quality
      An MCP server that allows Claude AI to perform filesystem operations including reading, writing, listing, moving files, and searching directories within specified allowed paths.
      Last updated -
      5
      1
      JavaScript
    • A
      security
      A
      license
      A
      quality
      An MCP server that provides tools for reading, writing, and editing files on the local filesystem.
      Last updated -
      1
      1,240
      Python
      Apache 2.0
      • Apple
    • -
      security
      F
      license
      -
      quality
      A Filesystem MCP server that allows an LLM to read and list files from a specified directory on your local machine through the Model Context Protocol.
      Last updated -
      2
      Python

    View all related MCP servers

    ID: ylzwo0zfry