About LocalSynapse
LocalSynapse is an MCP server in the Search category: offline AI-powered local file search MCP server for Windows. Searches inside document contents (Word, Excel, PDF, PowerPoint, HWP) using BM25 + dense vector hybrid search. 100% local, no cloud, no login, no telemetry. It has been installed 0 times through Conduid.
Install
git clone https://github.com/LocalSynapse/LocalSynapseThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about LocalSynapse
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
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.
README mirrored from the source repository 5 months ago. The original is authoritative.