Advertise
MCP.so
Sign In

MCP Server - File Search Tool

@RJTPP

Repository

Basic information

Category

Search

License

MIT license

Transports

stdio

Author

RJTPP

About MCP Server - File Search Tool

A Model Context Protocol (MCP) server for searching file content with regex across various file types

#mcp#file-search#regex

MCP Server - File Search Tool config

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

{
  "mcpServers": {
    "mcp-server-file-search-tool": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

MCP Server - File Search Tool 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 MCP Server - File Search Tool 🗂️?

An MCP (Model Context Protocol) server that provides powerful file system search and inspection capabilities via the MCP protocol. It allows users to list directories, search file names, read file contents (including PDF and DOCX), and perform regex‑based content searches with context. Designed for local, personal use.

How to use MCP Server - File Search Tool 🗂️?

After installing Python 3.10+ and uv, clone the repository, run uv sync to install dependencies, then start the server with uv run server.py (default port 6277). Configuration is done via config.json, where ALLOWED_PATHS is required. Can be integrated into Claude Desktop using the mcp install command or by manually editing claude_desktop_config.json.

Key features of MCP Server - File Search Tool 🗂️

  • List file paths: Breadth‑first or depth‑first listing with paging and nested‑level control.
  • Search file names: Regex‑based file name search.
  • Read files: Read text, PDF, and DOCX files with optional character limits.
  • Search file contents: Regex‑based content search with configurable context lines.
  • Allowed paths: Restrict server to only browse within configured directories.
  • Exclude paths: Prevent sensitive directories from being accessed.
  • Hide hidden files: Optionally ignore files and directories beginning with a dot.
  • Path masking: Replace configured path segments with tokens for privacy.

Use cases of MCP Server - File Search Tool 🗂️

  • Quickly locate files by name or content within allowed project directories.
  • Inspect text, PDF, and DOCX documents from an MCP‑compatible client.
  • Perform regex‑based code or log searches with surrounding context lines.
  • Enable AI assistants to retrieve files only from approved, sandboxed folders.

Frequently asked questions

1

What are the runtime requirements?

Python 3.10 or higher and the `uv` package manager are required.

2

Does the server support authentication or encryption?

No. The README explicitly warns that it does not implement authentication or encryption and is designed for local, personal use only.

3

How do I restrict which directories the server can access?

Set the required `ALLOWED_PATHS` in `config.json`. Optionally, set `EXCLUDE_PATHS` to block specific directories, even if inside allowed paths.

4

What file formats can the server read?

It can read plain text files, PDF files, and DOCX files.

5

Can I hide hidden files (dot‑prefix)?

Yes. Set `HIDE_HIDDEN_FILES` to `true` in the configuration to ignore files and directories starting with `.`.

Comments

More Search MCP servers

CueHQ

Russell Shen

CueHQ's MCP server gives your agent the Reddit, X, YouTube and TikTok threads where people ask for what you sell, ranked and deduplicated, with reply drafts in your voice that keep learning from your edits. It's for deve

C

Chalet-Montagne.com — Mountain holiday rentals

Alpium

Search mountain holiday rentals across the French Alps, Pyrenees and other massifs — check real availability and stay prices, then contact owners directly, commission-free. No account or authentication needed.

3

3gpp-mcp

higebu

An MCP (Model Context Protocol) server that makes 3GPP specifications accessible to LLMs.

13

patent-literature-search-mcp

patsnap

A professional tool for searching Patsnap’s global patent and literature databases using natural language, semantic, or keyword queries. It supports precise filtering and retrieves bibliographic data in Markdown format.

1

VerifyAPI

Circuit Savers LLC

Fact-check any claim with live web sources. Ed25519-signed receipts. Catches hallucinations.

Advertise