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
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