README.md

Name: README.md
Author: romanshablio

@romanshablio

Repository

About README.md

Lightweight Python HTTP service that searches local files by name and returns JSON results for tools such as Cline.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-romanshablio": {
      "command": "python",
      "args": [
        "mcp_server.py",
        "--port",
        "8080"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is File Finder Server?

File Finder Server is a small Python service that searches for files by name on the user's local computer and returns results as JSON. It was created as an MCP-style helper that can be connected to tools such as Cline in VS Code.

How to use File Finder Server?

Clone the repository, start the server with python mcp_server.py --port 8080, and configure Cline in VS Code by copying the appropriate configuration into cline_config.json and restarting Cline. The server exposes a single HTTP endpoint /search that accepts a query parameter.

Key features of File Finder Server

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

Use cases of File Finder Server

Automating local file search from external tools.
Providing a simple API for an AI assistant to locate files.
Integrating local file search into a GUI or other program.
Using with Cline in VS Code for quick file lookups.

FAQ from File Finder Server

What does File Finder Server do exactly?

It runs an HTTP server that scans the local computer for filenames matching a query string and returns the results as JSON. It also saves the results to search_results.json.

How do I start the server?

After cloning the repository, run python mcp_server.py --port 8080 from the project folder. The server will listen on the specified port (default 8080).

How do I test if the server is working?

Send a GET request to http://localhost:8080/search?query=example using curl, a browser, or another tool. The server will respond with a JSON array of matching files.

How do I connect File Finder Server to Cline in VS Code?

Open cline_config.json, copy the server configuration provided in the repository into it, and then restart Cline. The server will then be available as a tool within Cline.