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