MCP server de Synaptic
Commit 1 nov 2026Permite que un asistente de IA consulte el grafo de conocimiento del código de un repositorio para entender símbolos, rastrear el impacto de los cambios, seleccionar pruebas y buscar el historial de ingeniería.
También conocido como ColinVaughn/Synaptic, synaptic
- Stars
- 32
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 1.2.0
- Último commit
- 1 nov 2026
- Licencia
- AGPL-3.0
¿Qué es Synaptic MCP?
Synaptic es un MCP server. Permite que un asistente de IA consulte el grafo de conocimiento del código de un repositorio para entender símbolos, rastrear el impacto de los cambios, seleccionar pruebas y buscar el historial de ingeniería.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Synaptic
Mapear un repositorio en un grafo de conocimiento persistente permite a los desarrolladores dotar a sus asistentes de IA de una comprensión estructural de la base de código en lugar de solo archivos en bruto. Synaptic construye este grafo localmente usando un único binario de Rust, sin necesidad de bases de datos, cuentas o API keys para funcionar. Funciona a través de una CLI o un MCP server que se conecta a asistentes como Claude Code, Codex, Gemini y Cursor.
Al usar herramientas como synaptic query y synaptic affected, los usuarios pueden rastrear cómo los cambios impactan en símbolos específicos o identificar qué pruebas deben ejecutarse. El sistema se enfoca en la eficiencia del contexto, devolviendo al asistente solo el subgrafo relevante para reducir el uso de tokens. También proporciona acceso al historial de ingeniería mediante búsquedas de memoria y puede pronosticar riesgos usando el comando synaptic predict. Esta configuración permite un análisis arquitectónico profundo, incluyendo el seguimiento de imports, herencia y límites entre lenguajes, todo mientras se mantiene offline a menos que se habiliten funciones con respaldo de red.
Qué puedes hacer con él
- 1Analizar el impacto del códigoPide al asistente que identifique qué partes del sistema podrían romperse si se modifica un símbolo específico.
- 2Reducir el consumo de tokensProporciona a la IA información estructural precisa en lugar de subir archivos de código fuente completos.
- 3Buscar el historial de ingenieríaRecupera contexto de commits, decisiones o reviews pasadas para entender por qué existe cierto código.
- 4Verificar cambios arquitectónicosUsa un worktree temporal para probar cómo un cambio propuesto afecta a la base de código existente.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Synaptic MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Synaptic MCP en Claude Code
$ claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstalar Synaptic MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Instalar Synaptic MCP en VS Code
.vscode/mcp.json
{
"servers": {
"synaptic": {
"type": "http",
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Instalar Synaptic MCP en VS Code CLI
$ code --add-mcp '{"name":"synaptic","type":"http","url":"https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"}'Instalar Synaptic MCP en Codex
$ codex mcp add synaptic --url https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstalar Synaptic MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.synaptic] url = "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
Instalar Synaptic MCP en Gemini CLI
$ gemini mcp add -s user --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstalar Synaptic MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D",
"type": "http"
}
}
}Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblecolinvaughn/synaptic is public and reachablegithub.com/colinvaughn/synaptic ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-01github.com/colinvaughn/synaptic ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPEndpoint did not answer initialize: HTTP 530Hallazgo
README
Ver en 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.
Preguntas sobre Synaptic MCP
¿Cómo agrego Synaptic MCP a Claude Code?
Ejecuta claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Synaptic MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Synaptic MCP requiere una API key o una base de datos?
No. Synaptic se distribuye como un único binario de Rust sin necesidad de runtime, base de datos, cuenta o API key, y la extracción de código se ejecuta de forma local y offline.
¿Cómo conecto Synaptic a Claude Code o Codex?
Ejecuta el comando de instalación para tu asistente, como synaptic install claude o synaptic install codex; usa --global para la aplicación de escritorio de Codex.
¿Qué puede decirme Synaptic sobre el impacto de un cambio de código?
Rastrea el impacto inverso de un símbolo, pronostica riesgos y selecciona las pruebas afectadas, con verificación opcional en un worktree aislado.
¿Puede Synaptic buscar en el historial y las decisiones pasadas del repositorio?
Sí, construye un historial vinculado al código a partir de commits, decisiones, incidentes, reviews, CI e intentos previos, que puedes buscar con synaptic memory search.
¿Synaptic ejecuta un MCP server?
Sí, synaptic serve ejecuta el MCP server, y también se ofrece un servicio gestionado a través de Synaptic Cloud.