file-find-mcp

file-find-mcp

1
file_systems

File Find MCP is a specialized server that enables fast and efficient file searches within a filesystem using Rust and ripgrep. It supports the Model Context Protocol (MCP) for compatibility with AI assistants and provides tools for both keyword search and file content reading.

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