README.md•1.19 kB
# 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:
```json
{
"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
```