Synaptic MCP server
Commit 1 Nov 2026Memungkinkan AI assistant untuk melakukan query ke knowledge graph kode dalam sebuah repository guna memahami simbol, melacak dampak perubahan, memilih test, dan mencari riwayat engineering.
Juga dikenal sebagai ColinVaughn/Synaptic, synaptic
- Stars
- 32
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.2.0
- Commit terakhir
- 1 Nov 2026
- Lisensi
- AGPL-3.0
Apa itu Synaptic MCP?
Synaptic adalah MCP server. Memungkinkan AI assistant untuk melakukan query ke knowledge graph kode dalam sebuah repository guna memahami simbol, melacak dampak perubahan, memilih test, dan mencari riwayat engineering.
Ringkasan dibuat dari README proyek
Tentang Synaptic MCP server
Memetakan sebuah repository ke dalam persistent knowledge graph memungkinkan developer untuk memberikan pemahaman struktural codebase kepada AI assistant mereka, bukan sekadar file mentah. Synaptic membangun graph ini secara lokal menggunakan single Rust binary, tanpa memerlukan database, akun, atau API key untuk berfungsi. Tool ini bekerja melalui CLI atau MCP server yang terhubung ke assistant seperti Claude Code, Codex, Gemini, dan Cursor.
Dengan menggunakan tool seperti synaptic query dan synaptic affected, pengguna dapat melacak bagaimana perubahan berdampak pada simbol tertentu atau mengidentifikasi test mana yang perlu dijalankan. Sistem ini berfokus pada efisiensi konteks, dengan hanya mengembalikan subgraph yang relevan ke assistant untuk mengurangi penggunaan token. Synaptic juga menyediakan akses ke riwayat engineering melalui memory search dan dapat memprediksi risiko menggunakan command synaptic predict. Setup ini memungkinkan analisis arsitektur yang mendalam, termasuk melacak import, inheritance, dan batasan antar bahasa (cross-language), semuanya tetap berjalan secara offline kecuali jika fitur berbasis jaringan diaktifkan.
Apa yang bisa Anda lakukan dengannya
- 1Analyze code impactMinta assistant untuk mengidentifikasi bagian sistem mana yang mungkin rusak jika sebuah simbol tertentu dimodifikasi.
- 2Reduce token consumptionBerikan informasi struktural yang presisi kepada AI alih-alih mengunggah seluruh file source code.
- 3Search engineering historyAmbil konteks dari commit, keputusan, atau review masa lalu untuk memahami alasan mengapa kode tertentu dibuat.
- 4Verify architectural changesGunakan throwaway worktree untuk menguji bagaimana usulan perubahan berdampak pada codebase yang ada.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Synaptic MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Synaptic MCP di Claude Code
$ claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstal Synaptic MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Instal Synaptic MCP di VS Code
.vscode/mcp.json
{
"servers": {
"synaptic": {
"type": "http",
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
}
}
}Instal Synaptic MCP di VS Code CLI
$ code --add-mcp '{"name":"synaptic","type":"http","url":"https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"}'Instal Synaptic MCP di Codex
$ codex mcp add synaptic --url https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstal Synaptic MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.synaptic] url = "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D"
Instal Synaptic MCP di Gemini CLI
$ gemini mcp add -s user --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7DInstal Synaptic MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"synaptic": {
"url": "https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D",
"type": "http"
}
}
}Pengecekan otomatis
Berjalan 13 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaucolinvaughn/synaptic is public and reachablegithub.com/colinvaughn/synaptic ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-01github.com/colinvaughn/synaptic ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPEndpoint did not answer initialize: HTTP 530Temuan
README
Lihat di 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.
Pertanyaan tentang Synaptic MCP
Bagaimana cara menambahkan Synaptic MCP ke Claude Code?
Jalankan claude mcp add --transport http synaptic https://synapticgraph.com/api/mcp/projects/%7Bproject_id%7D di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Synaptic MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah Synaptic MCP memerlukan API key atau database?
Tidak. Synaptic hadir sebagai single Rust binary tanpa memerlukan runtime, database, akun, atau API key, dan proses ekstraksi kode berjalan secara lokal dan offline.
Bagaimana cara menghubungkan Synaptic ke Claude Code atau Codex?
Jalankan command install untuk assistant Anda, seperti synaptic install claude atau synaptic install codex; gunakan --global untuk aplikasi desktop Codex.
Apa yang bisa diberitahukan Synaptic mengenai dampak dari perubahan kode?
Synaptic melacak reverse impact untuk sebuah simbol, memprediksi risiko, dan memilih test yang terdampak, dengan opsi verifikasi di dalam worktree yang terisolasi.
Bisakah Synaptic mencari riwayat repository dan keputusan masa lalu?
Ya, Synaptic membangun riwayat yang terhubung dengan source code dari commit, keputusan, insiden, review, CI, dan upaya sebelumnya, yang dapat dicari menggunakan synaptic memory search.
Apakah Synaptic menjalankan MCP server?
Ya, synaptic serve menjalankan MCP server, dan layanan terkelola juga tersedia melalui Synaptic Cloud.