Colton-wq/mcp-everything-search-enhanced

MCP Everything Search Enhanced

An enhanced MCP (Model Context Protocol) server for fast file searching with improved regex support, error handling, and AI model compatibility. Based on the excellent work by Mamerto Fabian with significant improvements and bug fixes.

🚀 Key Enhancements

✅ Fixed Critical Issues

• Regex Support: Fixed broken regex: syntax processing that was completely non-functional in the original
• AI Model Compatibility: Resolved Schema generation errors that caused failures with qwen3 and other AI models
• Error Handling: Comprehensive error handling with user-friendly messages and detailed logging
• DLL Path Management: Intelligent fallback system for Everything SDK DLL detection

🆕 New Features

• Enhanced Debugging: Detailed logging for troubleshooting and development
• Improved Schema: Fixed $defs references that caused AI model incompatibility
• Better Error Messages: Clear, actionable error messages instead of cryptic failures
• Robust Path Handling: Multiple fallback paths for Everything SDK DLL

📊 Performance Improvements

• Faster Queries: Optimized query processing with intelligent caching
• Memory Efficiency: Better resource management and cleanup
• Stability: Extensive testing with 1000+ result queries and complex regex patterns

🆚 Comparison with Original

📦 Installation

Via pip (Recommended)

pip install mcp-server-everything-search-enhanced

From Source

git clone https://github.com/cy14700/mcp-everything-search-enhanced.git
cd mcp-everything-search-enhanced
pip install -e .

🔧 Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "everything-search-enhanced": {
      "command": "mcp-server-everything-search-enhanced",
      "args": []
    }
  }
}

Environment Variables

• EVERYTHING_SDK_DLL_PATH: Custom path to Everything SDK DLL (optional)

🎯 Usage Examples

Basic File Search

Find all Python files: *.py
Find files by size: size:>100mb
Find recent files: datemodified:today

Enhanced Regex Support (Fixed!)

Find executables: regex:.*\.(exe|dll)$
Find log files: regex:.*\.log$
Find config files: regex:.*(config|settings)\.(json|yaml|ini)$

Advanced Queries

Complex search: ext:py datemodified:today size:>1kb
Path matching: path:C:\Projects *.js
Case sensitive: case: MyFile.txt

🔍 Search Syntax Guide

🛠️ Development

Running Tests

# Install development dependencies
pip install -e ".[dev]"

# Run tests
python -m pytest tests/

# Run with coverage
python -m pytest --cov=mcp_server_everything_search tests/

Building

# Build package
python -m build

# Install locally
pip install dist/mcp_server_everything_search_enhanced-*.whl

🐛 Troubleshooting

Common Issues

"Everything SDK not found"

• Install Everything from voidtools.com
• Ensure Everything is running
• Set EVERYTHING_SDK_DLL_PATH if needed

"Regex queries not working"

• ✅ Fixed in Enhanced Version! The original had broken regex support
• Use regex: prefix: regex:.*\.exe$
• Check regex syntax (JavaScript/Rust compatible)

"Schema errors with AI models"

• ✅ Fixed in Enhanced Version! Resolved qwen3 and other AI model compatibility
• Update to latest version

Debug Mode

Set environment variable for detailed logging:

export EVERYTHING_SEARCH_DEBUG=1

🙏 Acknowledgments

This project is based on the excellent work by Mamerto Fabian in the original mcp-everything-search project.

Original Contributors

• Mamerto Fabian - Original author and creator
• Henry Mao - Smithery CLI integration
• mj520 - Schema fixes and DLL path improvements
• All other contributors to the original project

Enhancements in This Fork

• Fixed critical regex syntax processing issues
• Resolved AI model Schema compatibility problems
• Enhanced error handling and user feedback
• Improved logging and debugging capabilities
• Added comprehensive testing and validation
• Performance optimizations and stability improvements

📄 License

MIT License - see file for details.

This project maintains the same MIT license as the original work, with proper attribution to all contributors.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Note: This enhanced version addresses critical bugs and compatibility issues found in the original project, while maintaining full backward compatibility and adding significant improvements.