joisun/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
