file-find-mcp
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:
- Rust installed - Install Rust
- 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 searchkeyword
: 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