Synaptic MCP server
Commit 1. Nov. 2026Ermöglicht es einem KI-Assistenten, den Code-Knowledge-Graph eines Repositories abzufragen, um Symbole zu verstehen, die Auswirkungen von Änderungen zu verfolgen, Tests auszuwählen und die Engineering-Historie zu durchsuchen.
Auch bekannt als ColinVaughn/Synaptic, synaptic
- Stars
- 32
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.2.0
- Letzter Commit
- 1. Nov. 2026
- Lizenz
- AGPL-3.0
Was ist Synaptic MCP?
Synaptic ist ein MCP server. Ermöglicht es einem KI-Assistenten, den Code-Knowledge-Graph eines Repositories abzufragen, um Symbole zu verstehen, die Auswirkungen von Änderungen zu verfolgen, Tests auszuwählen und die Engineering-Historie zu durchsuchen.
Zusammenfassung generiert aus dem README des Projekts
Über Synaptic MCP server
Das Mapping eines Repositories in einen persistenten Knowledge-Graph ermöglicht es Entwicklern, ihren KI-Assistenten ein strukturelles Verständnis einer Codebase zu vermitteln, anstatt nur Rohdateien bereitzustellen. Synaptic erstellt diesen Graphen lokal mithilfe einer einzelnen Rust-Binary, die keine Datenbank, Accounts oder API-Keys für die Funktion benötigt. Es arbeitet über ein CLI oder einen MCP server, der sich mit Assistenten wie Claude Code, Codex, Gemini und Cursor verbindet.
Durch die Nutzung von Tools wie synaptic query und synaptic affected können Nutzer nachverfolgen, wie Änderungen spezifische Symbole beeinflussen, oder identifizieren, welche Tests ausgeführt werden müssen. Das System konzentriert sich auf Kontext-Effizienz und gibt nur den relevanten Subgraphen an den Assistenten zurück, um den Token-Verbrauch zu reduzieren. Es bietet zudem Zugriff auf die Engineering-Historie durch Memory-Searches und kann Risiken mit dem Befehl synaptic predict prognostizieren. Dieses Setup ermöglicht tiefe Architekturanalysen, einschließlich der Verfolgung von Imports, Vererbung und sprachübergreifenden Grenzen, während alles offline bleibt, sofern keine netzwerkbasierten Features aktiviert sind.
Was du damit machen kannst
- 1Code-Auswirkungen analysierenFrage den Assistenten, welche Teile des Systems beschädigt werden könnten, wenn ein spezifisches Symbol geändert wird.
- 2Token-Verbrauch reduzierenVersorge die KI mit präzisen strukturellen Informationen, anstatt komplette Quelldateien hochzuladen.
- 3Engineering-Historie durchsuchenRufe Kontext aus vergangenen Commits, Entscheidungen oder Reviews ab, um zu verstehen, warum bestimmter Code existiert.
- 4Architektur-Änderungen verifizierenNutze einen temporären Worktree, um zu testen, wie eine vorgeschlagene Änderung die bestehende Codebase beeinflusst.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Synaptic MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenSynaptic MCP in Claude Code installieren
$ claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DSynaptic MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Synaptic MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"synaptic": {
"type": "http",
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Synaptic MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"synaptic","type":"http","url":"https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"}'Synaptic MCP in Codex installieren
$ codex mcp add synaptic --url https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DSynaptic MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.synaptic] url = "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
Synaptic MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DSynaptic MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D",
"type": "http"
}
}
}Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarcolinvaughn/synaptic is public and reachablegithub.com/colinvaughn/synaptic ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-01github.com/colinvaughn/synaptic ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeEndpoint did not answer initialize: HTTP 530Befund
README
Auf GitHub ansehenSynaptic
Give your coding assistant a map of the codebase, not a pile of files.
Synaptic maps a repository once so you and your coding assistant do not have to rediscover it every session. Ask how a system works, what depends on a symbol, or what a change may break. The answers come from a persistent, source-grounded knowledge graph, available from the CLI or through MCP. Synaptic can also remember past changes and plan small, reviewable API and dependency repairs.
Code extraction is local and deterministic. Synaptic ships as a single Rust binary with no runtime, database, account, or API key required.
Documentation | Quickstart | Benchmarks | Discord
Get started
Install the latest checksummed release:
# macOS / Linux
curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.sh | sh
# Windows PowerShell
irm https://raw.githubusercontent.com/ColinVaughn/Synaptic/main/install.ps1 | iex
Then run Synaptic from a repository:
synaptic extract . # build synaptic-out/graph.json
synaptic query "how does authentication work?"
synaptic affected parse_config # what could this change break?
Extraction honors .gitignore and .synapticignore, skips common secret files, and stays
offline unless you explicitly enable a network-backed feature.
Connect your coding assistant
synaptic install claude # Claude Code
synaptic install codex # Codex CLI
synaptic install codex --global # Codex desktop app
Claude and Codex load only a small set of tools at startup, then find the rest on demand. This
keeps prompts smaller without hiding capabilities. Gemini, Cursor, Copilot, OpenCode, Kilo,
and generic AGENTS.md clients are supported too. See
Assistant Integration.
What it does
| Need | What Synaptic provides |
|---|---|
| Understand the code | Symbols, calls, imports, inheritance, resources, SQL, and cross-language boundaries in one graph |
| Find impact | Callers, references, reverse dependencies, dynamic-dispatch hazards, and affected tests |
| Change code safely | Change forecasts, refactor plans, architecture diffs, and optional verification in an isolated worktree |
| Remember the past | Source-linked history from commits, decisions, incidents, reviews, CI, and previous attempts |
| Maintain dependencies | API contract tracking and vulnerability evidence with small, reviewable repair workflows |
Synaptic supports dozens of languages, incremental updates, multi-repository federation, structural search, SQL auditing, graph-aware PR review, and exports for GraphML, Cypher, Graphviz, Obsidian, and Markdown. Detailed capabilities live in the documentation, keeping this page focused on getting started.
See the architecture
synaptic chart
This creates a self-contained architecture map from the graph. Open a subsystem, select a symbol, and follow its real incoming and outgoing relationships without a server.
Built to save context
Synaptic returns the relevant slice of a graph instead of loading whole source files into an assistant's context. In the checked-in token benchmark, full graph answers used 27-38x fewer tokens than reading the source files referenced by those answers. That is a context-compression measurement, not a promise about total task cost. The methodology and raw results are in BENCHMARKS.md.
Common commands
| Command | Purpose |
|---|---|
synaptic extract . |
Build the graph |
synaptic update / synaptic watch |
Keep it current |
synaptic query "..." |
Find the relevant subgraph for a question |
synaptic affected <symbol> |
Trace reverse impact |
synaptic predict <files> |
Forecast risk and select tests |
synaptic speculate <files> |
Verify a change in a throwaway worktree |
synaptic memory search "..." |
Find relevant repository history |
synaptic serve |
Run the MCP server |
Run synaptic <command> --help for flags or use the complete
command reference.
Pick a workflow
- CLI: the fastest path for local extraction, queries, automation, and MCP.
- Desktop: run
synaptic-uifor visual repository setup, federation, assistant connection, updates, and the complete command catalog. - Hosted: Synaptic Cloud provides a managed MCP service. See the GitHub automation guide for commit-triggered graph sync and verified repair workflows.
Update a release installation with synaptic self-update.
Documentation
- Installation and Quickstart
- Querying, languages, and output formats
- MCP server and assistant integration
- Repository memory, API maintenance, and vulnerability management
- Workspaces and federation, configuration, and development
Build from source
The repository pins Rust 1.97.1.
cargo install --path bin/synaptic
cargo install --path bin/synaptic-ui # optional desktop app
For development and architecture notes, see the development guide.
Community and license
Questions, ideas, or something you built? Join the Discord community.
Synaptic is licensed under AGPL-3.0-or-later; see LICENSE and NOTICE.
If you modify Synaptic and make it available over a network, you must offer those users the
corresponding source. The separately maintained Synaptic Cloud service is proprietary and is
not covered by this repository's license.
Synaptic MCP Fragen
Wie füge ich Synaptic MCP zu Claude Code hinzu?
Führe claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Synaptic MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Benötigt Synaptic MCP einen API-Key oder eine Datenbank?
Nein. Synaptic wird als einzelne Rust-Binary ohne Runtime, Datenbank, Account oder API-Key ausgeliefert, und die Code-Extraktion läuft lokal und offline.
Wie verbinde ich Synaptic mit Claude Code oder Codex?
Führe den Install-Befehl für deinen Assistenten aus, wie zum Beispiel synaptic install claude oder synaptic install codex; verwende --global für die Codex Desktop App.
Was kann mir Synaptic über die Auswirkungen einer Code-Änderung sagen?
Es verfolgt die Rückwirkung (Reverse Impact) eines Symbols, prognostiziert Risiken und wählt betroffene Tests aus, mit optionaler Verifizierung in einem isolierten Worktree.
Kann Synaptic die vergangene Repository-Historie und Entscheidungen durchsuchen?
Ja, es erstellt eine quelltextverknüpfte Historie aus Commits, Entscheidungen, Incidents, Reviews, CI und früheren Versuchen, die mit synaptic memory search durchsuchbar ist.
Betreibt Synaptic einen MCP server?
Ja, synaptic serve startet den MCP server, und ein Managed Service wird zusätzlich über Synaptic Cloud angeboten.