search-filesLABSCO SUMMARY
"Where did I put that file", answered with metadata.
Returning size and creation date alongside the path is what makes this more than a find wrapper: when three files share a name, those two fields usually decide which one you meant. Pass a directory to keep the search inside the tree you care about — left out, it starts at the root and walks everything.
What it is
A Python MCP server that searches the filesystem for files whose path contains a fragment you give, and returns them with their metadata.
What you get
search-files— a requiredquerypath fragment, and an optionaldirectoryto search under- Each match comes back with file name, full path, file size and creation date
- With no directory given, the search runs from the root
- A list rather than a single hit, so ambiguous names still get answered
Requirements
Uv. The client launches it with uv --directory <YOUR_PATH_TO_FILE_FINDER_MCP> run file-finder-mcp over stdio.
Setup effort
Build from source — git clone https://github.com/StepanCooleague/file-finder-mcp.git
USE CASES
01
Locating a file you half-remember
Search on the fragment of the name you do remember and pick from the matches by date.
02
Keeping a search fast
Pass the directory you expect it to be under rather than searching from the root.
03
Telling two copies apart
Compare the size and creation date on the returned matches before opening either.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/StepanCooleague/file-finder-mcp.gitPut the absolute path of the file-finder-mcp folder you just cloned after --directory in the block below. uv run sets up the project's environment (Python 3.12 or newer, per pyproject.toml) the first time your client starts it.
MCP Clients
Cline
CLINE · JSON
{
"mcpServers": {
"file-finder-mcp": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_FILE_FINDER_MCP>",
"run",
"file-finder-mcp"
]
}
}
}
