File Search MCP

File Search MCP indexes text files with Tantivy and returns relevant matches or file contents through a Rust MCP server.

Local serverstdioRustMIT

What is the File Search MCP Server?

File Search MCP indexes text files with Tantivy and returns relevant matches or file contents through a Rust MCP server.

Search a local text collection

The project uses Tantivy to build an in-memory index for text files in a selected directory. It skips binary files and ranks search hits by relevance. A separate reader returns file content for a supplied path. This makes it useful for an assistant answering questions over notes, source files or local documentation.

Source and runtime

The repository documents a compiled release binary as the MCP command. Build the Rust project before using that path; a source checkout does not contain the release executable automatically. The server uses the Rust MCP SDK and Tokio runtime.

A useful first search

Choose a small directory with several known text files. Search for a distinctive word, inspect the ranked paths and read the relevant file. Then test a word that is absent. A relevance score ranks matches within the index; it does not certify that the highest result answers a particular question.

Index lifetime and access

The documented index is temporary and lives in memory. Recreating a process can require indexing again, which affects startup time and memory for large collections. Supply a directory with appropriate scope, since the reader operates on local file paths. Keep source files and query results together when checking an answer that the assistant derives from the retrieved content.

Project documentation

Repository and setup guide

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
command<path-to-repo>/target/release/file-search-mcp

Configuration

A Rust toolchain for building the project and access to the intended text directory.

Example prompts to try

  • “Use File Search MCP to command.”

Frequently asked questions

This is the project maintained in the linked repository. Its documentation defines the supported tools, runtime and access requirements.