File Finder

Finds files by path fragment on the filesystem and returns JSON results for easy integration.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kyan9400-file-finder-mcp": {
      "command": "python",
      "args": [
        "file_finder_server.py"
      ]
    }
  }
}

This MCP server lets you search the filesystem for file path fragments and returns matching files in JSON format, enabling seamless integration with editors and tools that rely on Model Context Protocol. It is lightweight, easy to run locally, and starts from your current working directory to find files that match your query.

How to use

You use this server by querying it through an MCP client. The server searches your filesystem for a fragment of a path you provide and returns a JSON array of matching files. Each result includes the file name, full path, size in bytes, and creation timestamp in ISO format. The search is case-insensitive, and results are relative to the directory you started the server from.

How to install

Prerequisites: Python 3.9 or higher, the Python package mcp, and VSCode with the Cline extension.

Clone the repository and navigate into it.

git clone https://github.com/kyan9400/file-finder-mcp.git
cd file-finder-mcp

Install the required Python package.

pip install mcp

Configure your Cline setup to include the MCP server by adding the following to your Cline configuration file.

{
  "mcpServers": {
    "file-finder-mcp": {
      "args": ["file_finder_server.py"],
      "command": "python",
      "autoApprove": [],
      "disabled": false
    }
  }
}

Additional notes

To test locally, you can run the server manually using Python. You may also rely on Cline to start it automatically when you use the MCP tool.

Key behavior to remember:

The search starts from the current working directory where you launch the server.
The search is case-insensitive.
The reported size is in bytes and the creation date uses ISO format.

Available tools

find_files

Search the filesystem starting from the server's working directory for file path fragments and return a JSON array of matching files, including file_name, path, size in bytes, and created ISO timestamp.