What is File Find Mcp

File Find MCP is a specialized Model Context Protocol (MCP) server designed for fast file searching within a filesystem, built with Rust and utilizing ripgrep for efficient content searching.

Use cases

Use cases include searching for specific keywords in source code files, quickly locating configuration files, and analyzing text data in research projects.

How to use

To use File Find MCP, ensure you have Rust and ripgrep installed. Clone the repository, build the project using Cargo, and configure your MCP settings to include the path to the compiled binary.

Key features

Key features include high-performance search capabilities using ripgrep, the ability to read and display text file contents, smart detection of text files while skipping binary files, integration with MCP-compatible systems, and a fallback mechanism using pure Rust if ripgrep is unavailable.

Where to use

File Find MCP can be used in software development environments, data analysis tasks, and any application requiring efficient file content searching within a directory structure.

File Find MCP

A specialized Model Context Protocol (MCP) server for fast file search within a filesystem, built with Rust and powered by ripgrep.

🔍 Overview

File Find MCP is a tool that provides powerful search capabilities for files in a specified directory. It uses ripgrep to perform high-performance searches through file content efficiently.

This project implements the Model Context Protocol (MCP), making it compatible with AI assistants and other systems that support the protocol.

✨ Features

• High-performance search: Uses ripgrep for extremely fast searches across directory structures
• File content reader: Read and display the content of specific text files
• Smart file detection: Automatically identifies text files and skips binary files
• MCP integration: Works with systems that support the Model Context Protocol
• Fallback mechanism: Uses pure Rust implementation when ripgrep command is not available

📋 Prerequisites

Before using this tool, make sure you have:

1. Rust installed - Install Rust
2. ripgrep installed - On macOS, you can install it using Homebrew:

   brew install ripgrep
   

📦 Building

To build the project:

# Clone the repository
git clone https://github.com/joisun/file-find-mcp
cd file-find-mcp

# Build in release mode
cargo build --release

The compiled binary will be available at target/release/file-find-mcp.

⚙️ Configuration

Add this to your MCP settings (in Cursor, Claude, or other MCP-compatible tools):

{
  "mcpServers": {
    "file-find-mcp": {
      "command": "/path/to/your/file-find-mcp/target/release/file-find-mcp"
    }
  }
}

Replace /path/to/your/file-find-mcp with the actual path to your cloned repository.

🛠️ Available Tools

Search Tool

• Description: Search for keywords in text files within a specified directory
• Parameters:
  • directory: Path to the directory to search
  • keyword: Keyword to search for

File Content Reader Tool

• Description: Read and display the content of a specific file
• Parameters:
  • file_path: Path to the file to read

📄 License

MIT License

🙏 Acknowledgements

• ripgrep for the lightning-fast search capabilities
• RMCP for the Model Context Protocol implementation
• This project is forked from file-search-mcp and modified to use ripgrep for improved search efficiency