Local file search engine with MCP server. Indexes files across all drives and provides full-text search, filename search, and semantic search — all running 100% offline.
- File scanning — Indexes all fixed drives, skips cloud placeholders (OneDrive, Dropbox, etc.)
- Full-text search — BM25 ranking with Porter stemmer, Korean/English support
- Semantic search — BGE-M3 embedding model (optional, runs locally via ONNX)
- MCP server — stdio JSON-RPC server for AI assistant integration
- Desktop UI — Avalonia cross-platform GUI
dotnet build LocalSynapse.v2.sln# GUI
dotnet run --project src/LocalSynapse.UI
# MCP server
dotnet run --project src/LocalSynapse.UI -- mcpsrc/
LocalSynapse.Core/ # Models, Interfaces, DB
LocalSynapse.Pipeline/ # Scan, parse, chunk, embed
LocalSynapse.Search/ # BM25, Dense, Hybrid search
LocalSynapse.Mcp/ # MCP stdio server
LocalSynapse.UI/ # Avalonia desktop app
Add LocalSynapse as an MCP server in your Claude Desktop or Claude Code config:
{
"mcpServers": {
"localsynapse": {
"command": "C:\\Program Files\\LocalSynapse\\LocalSynapse.exe",
"args": ["mcp"],
"env": {}
}
}
}| Tool | Description |
|---|---|
search_files |
Search files by keyword or semantic query |
get_file_content |
Read the content of an indexed file |
list_indexed_files |
List all indexed files with filters |
get_pipeline_status |
Check indexing pipeline status |
LocalSynapse releases are signed to ensure authenticity and integrity.
Free code signing provided by SignPath.io, certificate by SignPath Foundation.
- Authors & Reviewers: Repository Owner
- Approvers: Organization Owners
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.
All file indexing, search, and AI embedding operations run 100% locally on your machine. No data is sent to any external server. No login or account is required.