File Search

Blazingly fast MCP server for searching files and content in large codebases and monorepos.

javascript

0

GitHub Stars

javascript

Language

6 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": {
    "elad12390-file-search-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "file-search-mcp"
      ]
    }
  }
}

You can run file-search-mcp as an MCP server to quickly locate files and text across large codebases and monorepos. It offers fast content search, smart defaults, and safe traversal to keep results relevant and efficient.

How to use

You connect an MCP client to this server to search files and content across your projects. Use the client’s MCP configuration to point at the server and then run your usual search commands from your editor or tool. Expect fast results, smart case handling, and useful context around matches.

Common usage patterns you can achieve with this server include finding files by name or pattern, searching within files for text or regular expressions, performing fuzzy name lookups, and visualizing project structure. You’ll also benefit from defaults that skip binary files, respect your .gitignore, and avoid overwhelming results through token limiting.

Key features you’ll use regularly include smart case handling (case-insensitive unless you use uppercase in your query), automatic binary detection, symlink safety with loop detection, and configurable detail levels to control how much information you receive per result.

To integrate with an MCP client, reference one of the available server configurations shown in the installation section and enable the server in your client’s MCP settings.

How to install

Prerequisites you need before installing this MCP server:

Node.js 18+
ripgrep (required for content search)

Install ripgrep using your platform’s package manager, then install the MCP server code as shown below.

Quick Start via npx

Global Install

Install the MCP server globally and configure your client to use the local command.

{
  "mcpServers": {
    "file_search": {
      "command": "file-search-mcp"
    }
  }
}

Quick Start via npx (explicit config)

If you want to run the MCP server on demand from your client configuration, use npx with the package name.

{
  "mcpServers": {
    "file_search": {
      "command": "npx",
      "args": ["-y", "file-search-mcp"]
    }
  }
}

Usage with Claude Desktop

Add the MCP server to Claude Desktop’s config to enable file searches from within Claude.

{
  "mcpServers": {
    "file_search": {
      "command": "npx",
      "args": ["-y", "file-search-mcp"]
    }
  }
}

Usage with OpenCode

Configure OpenCode to connect to the local MCP server for integrated search capabilities.

{
  "mcp": {
    "file_search": {
      "type": "local",
      "command": ["npx", "-y", "file-search-mcp"]
    }
  }
}

Available tools

search_files

Find files by name or glob pattern with options for modified date, size, and more.

search_content

Find text or regex patterns inside files with optional file patterns and context lines.

fuzzy_find

Fuzzy search for approximate file or symbol names when you don’t recall exact names.

tree

Visualize the project directory structure with configurable depth and filters.