Everything Mcp Server

Everything MCP Server

[](https://opensource.org/licenses/MIT) [](https://nodejs.org/) [](https://www.typescriptlang.org/)

A Model Context Protocol (MCP) server that provides instant file search capabilities using Everything's native SDK. This server integrates Everything's powerful search engine with AI tooling, enabling lightning-fast file system searches through the MCP interface.

Features

• 🔍 Instant File Search: Leverage Everything's instant indexing for near-instantaneous file searches
• 🎯 Advanced Filtering: Search by path, extension, size, date modified, and more
• 🔄 Duplicate Detection: Find duplicate files across your system
• 📄 Content Search: Search within file contents (requires Everything content indexing)
• ⚡ High Performance: Direct API access through native SDK integration
• 🛡️ Read-Only: Safe, non-destructive file system access

Tools Provided

1. search_files

Basic file search with regex and case sensitivity options.

Parameters:

• query (string): Search query for file names
• maxResults (number, optional): Maximum results to return (default: 100)
• matchCase (boolean, optional): Enable case-sensitive search
• matchWholeWord (boolean, optional): Match whole words only
• regex (boolean, optional): Enable regular expression search

2. search_files_advanced

Advanced search with comprehensive filtering options.

Parameters:

• query (string): Search query for file names
• path (string, optional): Limit search to specific path
• extension (string, optional): Filter by file extension (e.g., 'txt', 'pdf')
• size (string, optional): Filter by file size (e.g., '>1mb', '1mb"

Date Modified: "thisweek" Sort: "size_desc"

### Find Duplicates

Filename: "config.json" Path: "C:\\Projects" (optional)

### Content Search

Content: "function main" File Types: "js;ts;py" Path: "C:\\Code" (optional)

## Architecture

### Technology Stack
- **Language**: TypeScript
- **Framework**: MCP SDK (@modelcontextprotocol/sdk)
- **FFI Library**: koffi (for native DLL integration)
- **Module System**: ES modules
- **Target**: Everything SDK (Windows file search utility)

### Key Components
1. **Main Server** (`src/index.ts`): Core MCP server implementation
2. **Everything SDK**: Native Windows DLLs for file search
3. **Build System**: TypeScript compilation to ES modules
4. **Configuration**: Package.json with ES module support

## Development

### Building
```bash
npm run build

Testing

Start the server directly to test:

node build/index.js

Project Structure

everything-mcp-server/
├── src/
│   └── index.ts          # Main server implementation
├── EverythingSDK/        # Everything native SDK files
│   └── dll/
│       ├── Everything32.dll
│       └── Everything64.dll
├── build/                # Compiled JavaScript output
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

Troubleshooting

"Everything search client is not running"

• Start Everything application
• Ensure it's not running in portable mode without service

"Connection closed" MCP error

• Check that build directory exists and contains index.js
• Verify Node.js path in MCP configuration
• Ensure Everything application is running

ES Module errors

• Verify package.json has "type": "module"
• Check import statements use .js extensions
• Ensure koffi is imported as default export

Performance Notes

• Everything indexes files instantly, searches are near-instantaneous
• Content search requires Everything to have content indexing enabled
• Large result sets are automatically limited (configurable per tool)
• Direct API access provides better performance than command-line interface

Security Considerations

• Server provides read-only file system access through Everything
• No file modification capabilities
• Respects Everything's own security and indexing settings
• Content search limited to files Everything has indexed

Contributing

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

License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Acknowledgments

• Everything by voidtools for the amazing file search utility
• Model Context Protocol for the MCP framework
• koffi for the excellent FFI library

Related Projects

• MCP SDK - TypeScript SDK for Model Context Protocol
• Everything - The file search utility this server integrates with

---

Note: This is a Windows-specific MCP server that requires the Everything application to be installed and running. For cross-platform file search solutions, consider other MCP servers or file search tools.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: peterparker57
• Source: peterparker57/everything-mcp-server
• License: MIT

Install and usage instructions live in the source repository linked above.