File Finder

You can search for files on your filesystem using a dedicated MCP server that exposes a focused file search tool. This server lets you look for files by a path fragment and returns metadata such as name, full path, size, and creation date, making it easy to locate files without manual digging through folders.

How to use

To use the server, connect with an MCP client and invoke the search-files tool. Provide a path fragment as query to find files whose paths include that fragment. Optionally, restrict the search to a specific base directory by supplying directory as an argument. If you omit the directory, the search runs from the root directory. You will receive a list of matching files with their metadata including file name, full path, size, and creation date.

How to install

Prerequisites: ensure you have a runtime capable of executing the MCP host commands (the example uses uv). Have a location on disk where you want the MCP to operate. You will create a configuration file that defines the MCP server.

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

Additional sections

Configuration shown here enables the MCP server to operate with a local runtime. The server exposes a single tool named search-files that you can call through your MCP client by passing a required query string and an optional directory to narrow the search base.

Security and access controls should be considered in your deployment. Limit access to the MCP endpoint to trusted clients and monitor usage to prevent abuse of the file search capability.

Testing tip: you can try a prompt like “hi can you find files called file_to_find on my desktop using my mcp server” to verify that the tool returns matching files with their metadata.

Available tools

search-files

Searches for files matching a given path fragment. Requires a query string and accepts an optional directory to limit the search base; returns matching files with name, full path, size, and creation date.