Serveur MCP Synaptic
Commit 1 nov. 2026Permet à un assistant IA d'interroger le graphe de connaissances du code d'un dépôt pour comprendre les symboles, tracer l'impact des modifications, sélectionner des tests et rechercher l'historique d'ingénierie.
Aussi connu sous ColinVaughn/Synaptic, synaptic
- Étoiles
- 32
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 1.2.0
- Dernier commit
- 1 nov. 2026
- Licence
- AGPL-3.0
Qu'est-ce que Synaptic MCP ?
Synaptic est un serveur MCP. Permet à un assistant IA d'interroger le graphe de connaissances du code d'un dépôt pour comprendre les symboles, tracer l'impact des modifications, sélectionner des tests et rechercher l'historique d'ingénierie.
Résumé généré à partir du README du projet
À propos du MCP server Synaptic
La modélisation d'un dépôt sous forme de graphe de connaissances persistant permet aux développeurs de fournir à leurs assistants IA une compréhension structurelle d'une base de code plutôt que de simples fichiers bruts. Synaptic construit ce graphe localement à l'aide d'un unique binaire Rust, ne nécessitant ni base de données, ni compte, ni clé API pour fonctionner. Il fonctionne via une CLI ou un MCP server qui se connecte à des assistants tels que Claude Code, Codex, Gemini et Cursor.
En utilisant des outils comme synaptic query et synaptic affected, les utilisateurs peuvent tracer l'impact des changements sur des symboles spécifiques ou identifier quels tests doivent être exécutés. Le système mise sur l'efficacité du contexte en ne renvoyant que le sous-graphe pertinent à l'assistant afin de réduire la consommation de tokens. Il permet également d'accéder à l'historique d'ingénierie via des recherches mémorielles et peut prévoir les risques grâce à la commande synaptic predict. Cette configuration permet une analyse architecturale approfondie, incluant le suivi des imports, de l'héritage et des limites entre différents langages, tout en restant hors ligne, sauf si des fonctionnalités nécessitant un réseau sont activées.
Ce que vous pouvez faire avec
- 1Analyser l'impact du codeDemandez à l'assistant d'identifier quelles parties du système pourraient être affectées si un symbole spécifique est modifié.
- 2Réduire la consommation de tokensFournissez à l'IA des informations structurelles précises au lieu de charger l'intégralité des fichiers sources.
- 3Rechercher l'historique d'ingénierieRécupérez le contexte de commits, de décisions ou de revues passés pour comprendre pourquoi certains éléments de code existent.
- 4Vérifier les changements architecturauxUtilisez un worktree temporaire pour tester l'impact d'une modification proposée sur la base de code existante.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Synaptic MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Synaptic MCP dans Claude Code
$ claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstaller Synaptic MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Installer Synaptic MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"synaptic": {
"type": "http",
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Installer Synaptic MCP dans VS Code CLI
$ code --add-mcp '{"name":"synaptic","type":"http","url":"https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"}'Installer Synaptic MCP dans Codex
$ codex mcp add synaptic --url https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstaller Synaptic MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.synaptic] url = "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
Installer Synaptic MCP dans Gemini CLI
$ gemini mcp add -s user --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstaller Synaptic MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D",
"type": "http"
}
}
}Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblecolinvaughn/synaptic is public and reachablegithub.com/colinvaughn/synaptic ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-01github.com/colinvaughn/synaptic ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPEndpoint did not answer initialize: HTTP 530Faille
README
Voir sur GitHubSynaptic
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.
Questions sur Synaptic MCP
Comment ajouter Synaptic MCP à Claude Code ?
Exécutez claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Synaptic MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Synaptic MCP nécessite-t-il une clé API ou une base de données ?
Non. Synaptic est distribué sous la forme d'un unique binaire Rust sans runtime, base de données, compte ou clé API requis, et l'extraction de code s'effectue localement et hors ligne.
Comment connecter Synaptic à Claude Code ou Codex ?
Exécutez la commande d'installation pour votre assistant, telle que synaptic install claude ou synaptic install codex ; utilisez --global pour l'application de bureau Codex.
Que peut me dire Synaptic sur l'impact d'une modification de code ?
Il trace l'impact inverse pour un symbole, prévoit les risques et sélectionne les tests affectés, avec une vérification optionnelle dans un worktree isolé.
Synaptic peut-il rechercher l'historique et les décisions passées du dépôt ?
Oui, il construit un historique lié au code source à partir des commits, des décisions, des incidents, des revues, de la CI et des tentatives précédentes, consultable via synaptic memory search.
Synaptic exécute-t-il un MCP server ?
Oui, synaptic serve lance le MCP server, et un service managé est également proposé via Synaptic Cloud.