MCP File Finder Server

MCP File Finder Server is a small Python service for searching files by name on a local computer and returning results as JSON.

The project was created as a local MCP-style helper that can be connected to tools such as Cline in VS Code. It exposes an HTTP endpoint for search requests and saves the latest search results to search_results.json.

Features

• Runs locally on the user's computer.
• Exposes a simple HTTP search endpoint.
• Searches files by query.
• Returns results in JSON format.
• Saves search output to search_results.json.
• Can be connected to Cline in VS Code through configuration.

Installation and Running

1. Clone the repository.

   git clone <repository-url>
   cd <repository-folder>
   

   Copy

2. Start the MCP server.

   python mcp_server.py --port 8080
   

   Copy

3. Configure Cline in VS Code.

   • Open cline_config.json.
   • Copy the configuration into Cline.
   • Restart Cline.

Testing

Send a GET request:

curl "http://localhost:8080/search?query=example"

The server returns a JSON response with matching files.

How It Works

1. Start the server.
2. Send a search request through curl, a browser, or another tool.
3. The server scans the local computer for matching filenames.
4. Matching results are saved to search_results.json.
5. The response is returned as JSON.

Purpose

The main idea is to automate local file search and make it available to external tools. The server can later be connected to a GUI, an AI assistant, or another program that needs local file search through a simple API.