synapse-mcp

synapse-mcp

Give any AI instant knowledge of your codebase — local, private, no cloud.

Works with Claude Code, Cursor, Continue, Windsurf, and any MCP-compatible AI tool.

Install

No setup needed. Just run:

npx synapse-mcp

This automatically installs the Python package and starts the MCP server.

Quick start

# 1. Index your project
npx synapse-mcp synapse init C:/Projects/myapp

# 2. Register with Claude Code
claude mcp add synapse synapse-mcp

# 3. Restart your AI tool — it now knows your codebase

What it does

Synapse watches your project folders, indexes them locally using semantic embeddings, and connects to your AI tool via MCP. When you ask a question, it automatically injects the right code into context — you never have to paste files again.

CLI commands

npx synapse-mcp synapse init <path>      # Index a folder
npx synapse-mcp synapse status           # Show what's indexed
npx synapse-mcp synapse search <query>   # Search from terminal
npx synapse-mcp synapse explain <file>   # Understand a file
npx synapse-mcp synapse benchmark        # Measure retrieval quality
npx synapse-mcp synapse wipe             # Clear the index

Requires

• Node.js 16+
• Python 3.10+ (auto-detected)

Links

• GitHub
• Full documentation
• PyPI package

License

MIT