file-find-mcp

file-find-mcp

3.2

If you are the rightful owner of file-find-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

File Find MCP is a specialized Model Context Protocol server for fast file search within a filesystem, built with Rust and powered by ripgrep.

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