Localsynapse
LocalSynapse
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.
Features
- 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
Build
dotnet build LocalSynapse.v2.sln
Run
# GUI
dotnet run --project src/LocalSynapse.UI
# MCP server
dotnet run --project src/LocalSynapse.UI -- mcp
Project Structure
src/
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
MCP Configuration
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": {}
}
}
}
Available MCP Tools
| 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 |
License
Code Signing Policy
LocalSynapse releases are signed to ensure authenticity and integrity.
Free code signing provided by SignPath.io, certificate by SignPath Foundation.
Team Roles
- Authors & Reviewers: Repository Owner
- Approvers: Organization Owners
Privacy Policy
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.
Server Config
{
"mcpServers": {
"localsynapse": {
"command": "path/to/LocalSynapse.exe",
"args": [
"mcp"
]
}
}
}Recommend Servers
View AllWrite notes to Flomo
Playwright MCP server