Localsynapse

@LocalSynapse

Visit Server

11 days ago

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.

Overview Tools Comments

Overview

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

Apache License 2.0

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.

Try in Playground

Server Config

{
  "mcpServers": {
    "localsynapse": {
      "command": "path/to/LocalSynapse.exe",
      "args": [
        "mcp"
      ]
    }
  }
}

Build with ShipAny.