Advertise
MCP.so
Sign In

README.md MCP Server

@romanshablio

Repository

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

romanshablio

About README.md MCP Server

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

README.md MCP Server 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"
      ]
    }
  }
}

README.md MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

1

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

2

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).

3

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.

4

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.

5

Does the server require any authentication or special permissions?

No authentication is mentioned. The server runs locally and scans the filesystem using the permissions of the user who starts the process.

Comments

More Memory & Knowledge MCP servers

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.

Sooveryn

PANDAPROG

Sooveryn gives Claude Code a team of AI personas that remembers your project. Soov, the partner and team lead, keeps your decisions and how you work in a lasting memory, and finds them again by words and by meaning, from

Neither MCP

stonianua

Project context your AI can query through MCP — with source evidence.

M1K3

Round-Tower

Local AI agent for your Mac with a built-in MCP server: 18 tools for your notes and PDFs, a temporal memory graph, an on-device LLM and a neural voice. No account, no telemetry. No data centers required.

7

agentleFS

agentleFS

One permissioned folder your team and your AI agents both log into.

Advertise