Synapse MCP from Myelix Labs

⚡ 目前为预览版 — 我们期待您的反馈

通过开放的模型上下文协议（MCP），兼容所有主流 IDE 和智能体。

CursorClaude CodeWindsurfGitHub CopilotDevinAiderClineVS CodeJetBrains AICursorClaude CodeWindsurfGitHub CopilotDevinAiderClineVS CodeJetBrains AI

语言支持

50 种语言。一张图。

Synapse 开箱即用地为每种主流编程语言建立索引、分块并提取依赖边——无需插件、无需配置、无需云端。

函数式系统 / 底层面向对象 / 通用用途 教育 / 脚本 / 物联网数据 / 标记语言

Elixir Erlang Haskell F# OCaml Clojure Scala Python JavaScript TypeScript Go Ruby Rust Java C / C++ C# Kotlin Swift PHP Dart Perl R Zig Objective-C Groovy Julia SQL HTML CSS JSON Markdown YAML XML TOML HCL Dockerfile Protocol Buffers GraphQL Solidity PowerShell Pascal Lisp VBA Smalltalk Prolog Lua Assembly Shell Tcl Arduino

01 / 问题所在

为什么标准上下文引擎会让您的智能体“盲飞”

无论您使用的是免费的开源脚本，还是昂贵的企业级云端引擎，您的智能体仍然在盲目运行。以下是当您的 AI 试图理解代码时，幕后实际发生的事情。

01 失败

开源陷阱：“上下文膨胀器”

免费的 MCP 工具和 WASM 索引器只是自动化终端命令，或将图数据库查询直接转储到 LLM 中。如果您的智能体要求查看一个 10 行的函数，该工具会将整个 3,000 行的文件转储到您的提示词中。您会耗尽上下文窗口，用无关的背景噪音混淆 AI，并仅仅为了阅读括号语法而支付天文数字般的 API 账单。

02 失败

企业云陷阱：“IP 泄露”

昂贵的企业级上下文引擎会将您的专有代码库上传到他们的云端，以执行模糊的语义搜索。它们匹配字符串，但缺乏主动的写入验证。您会引发大规模的信息安全和合规性头痛。更糟糕的是，由于它们不会在本地模拟编辑，它们会放任 AI 编写破坏下游架构的代码。

03 优势

Synapse 优势：AST 感知的本地智能

Synapse-MCP 是一个编译好的、零依赖的二进制文件，100% 在本地运行。它为您的代码构建一个数学化的抽象语法树（AST）图。当智能体请求上下文时，Synapse 会剥离噪音，仅返回压缩的结构签名。在智能体写入文件之前，Synapse 会模拟编辑，以数学方式证明它不会破坏构建。

02 / 基准测试

证明：对 50 万行代码的单仓库进行自主安全审计

相同的前沿模型。相同的任务。发现相同的漏洞。唯一的区别是上下文引擎。

我们让一个 AI 智能体审计一个生产代码库。基线智能体使用标准的 shell 和 grep 工具。第二个智能体完全使用 Synapse-MCP。

−60% 成本与令牌

2.2 倍速度提升

100% 准确率

Elixir 代码库 · 相同前沿模型 · 自主安全审计

总令牌数

Shell

6,218,045

Synapse

2,487,914

-60%

API 成本

Shell

$12.63

Synapse

$5.05

-60%

墙钟时间

Shell

16 分 56 秒

Synapse

7 分 36 秒

2.2 倍速度提升

智能体操作

Shell

68 次 bash 调用

Synapse

36 次 MCP 调用

-47%

发现漏洞

Shell

3 个严重

Synapse

3 个严重

相同 03 / SYNAPSE

部署 Synapse-MCP

一个完全合规的 MCP 服务器。在 60 秒内将其插入任何兼容客户端，即可在您的团队工作的任何地方获得持久的结构化代码智能。

■ 100% 本地 🔒 端到端加密 ⚡ 亚秒级查询

免费

免费版 — “黄金图”

• 即时本地索引：在几秒内映射 50 种语言的 10,000+ 文件，零云端依赖。
• AST 感知压缩：在将文件负载发送到 LLM 之前缩小文件负载，阻止上下文耗尽。
• 三种搜索模式：用纯英语提问、按符号查找或按正则表达式模式搜索。
• 代码库洞察：自动检测语言分布、公共 API 表面和重构机会。
• 零配置设置：在您的 cursor_settings.json 中添加 5 行即可立即开始。

最受欢迎

专业版 — “影子图”（每月 $19）

• 模拟安全写入：编辑在触及磁盘之前先在内存中验证。如果编辑破坏了调用方的签名，会自动回滚。
• 影响与调用方分析：在 500 毫秒内显示整个仓库中受影响的每个调用方和依赖项。
• 即时崩溃解决：将堆栈跟踪直接映射到您的 AST 图，进行即时根因分析。
• 测试智能：无需运行测试套件即可揭示精确的覆盖缺口，并推荐精确的测试目标。
• 持久智能体记忆：AI 学到的洞察和摘要会保存到图中，使您的代码库在多个会话中变得更智能。

04 / 平台

13 个精密工具。一个上下文引擎。

将您的令牌账单削减 60%

如果您的智能体询问 PaymentService 如何工作，标准工具会发送一个 3,000 行的 JSON 负载。Synapse 解析 AST，剥离内部函数体，并发送一个仅包含公共接口和出站边的、经过外科手术式压缩的 150 令牌大纲。您的智能体以一小部分成本获得 10 倍的仓库结构。

传统智能体：转储整个文件。为每个空白和样板令牌付费。

了解您的更改如何产生涟漪

询问您的智能体：“如果我更改这个 User 结构体，会发生什么？”标准智能体会 grep 并猜测。Synapse 映射精确的影响——整个代码库中的每个入站调用方、下游被调用方和接口契约。在 AI 写下一行代码之前，您就能看到什么会破坏。

传统智能体：先写，后发现问题。

在保存之前已被证明的编辑

当标准智能体编写代码时，您只能祈祷它能编译。当 Synapse 驱动的智能体编写代码时，Synapse 会在内存中创建一个模拟的影子图。如果 AI 的编辑破坏了项目另一端的函数签名，Synapse 会在编辑写入磁盘之前拒绝它。

传统智能体：直接写入磁盘，留下损坏的代码供您调试。

即时崩溃解决

将堆栈跟踪粘贴给您的 AI。标准智能体执行缓慢、不准确的文本搜索。Synapse 解析运行时崩溃，将精确的帧匹配到本地代码库中已索引的块，并追踪执行路径以定位根因——您甚至无需启动应用程序。

传统智能体：字符串搜索跟踪，手动打开文件，猜测根因。

编写真正重要的测试

告诉您的智能体“为这个模块编写测试”。标准工具运行整个测试套件并猜测输入。Synapse 精确高亮当前未受保护的代码行。AI 编写修补真实结构缺口的行为测试。

传统智能体：运行完整测试套件并猜测覆盖范围。

100% 本地。零 IP 泄露。

企业 CISO 不希望专有代码上传到第三方数据库。Synapse 是一个编译好的、高度优化的二进制文件，完全在您的本地机器上运行。您的代码库永远不会离开您的笔记本电脑。无云端。无合规性头痛。

传统智能体：将您的代码库上传到第三方云搜索引擎。 05 / 使用方法

工程团队实际如何使用 Synapse

标准 AI 聊天窗口非常适合编写样板代码，但它们难以处理复杂的多文件软件工程。以下是添加 Synapse 如何改变真实工程任务的工作流程。

01

复杂架构重构

场景： 您要求您的 AI 解耦一个遗留的 Auth 模块。

❌ 标准 AI

对“auth”执行盲目的文本搜索，更新找到的文件，却遗漏了嵌套后台工作者中的十几个引用，并留下损坏的导入，让您不得不手动查找。

✅ Synapse-MCP

您的智能体在 500 毫秒内查询图，以映射您 4 个子服务中的每个调用方。它系统地重写调用方，并针对内存中的 AST 验证新函数签名——提供结构安全的重构，而不会出现损坏的运行时导入。

02

深入 Bug 排查

场景： 一个生产 webhook 丢弃了负载并返回 500 错误。

❌ 标准 AI

要求您手动查找并粘贴五个不同的文件，以便它尝试猜测它们如何连接，在此过程中丢失上下文。

✅ Synapse-MCP

您将原始堆栈跟踪粘贴到聊天中。Synapse 解析帧并将其直接映射到您已索引的本地图。智能体不是猜测，而是向后追踪执行路径，揭示可能的根因，为您节省一小时的手动文件跳转。

03

语义代码审查

场景： 一位初级开发人员打开了一个密集的 500 行拉取请求。

❌ 标准 AI

读取平面文本差异，并标记缺失的类型提示或命名不佳的变量。它不知道更改的文件如何影响应用程序的其余部分。

✅ Synapse-MCP

智能体将 PR 差异叠加到您代码库的 AST 图上。由于它理解更广泛的架构，它可以标记实际的下游回归：“这个 PR 在语法上看起来没问题，但它移除了 EmailService 依赖的事件发射。”您获得的是结构性影响审查，而不仅仅是浅层的语法检查器。

04

精确测试与覆盖

场景： 您继承了一个测试覆盖率为 30% 的旧模块，并要求 AI 改进它。

❌ 标准 AI

生成无用的“快乐路径”样板测试，大量模拟依赖项，捕获零个真实 Bug，只是为了虚增覆盖率指标。

✅ Synapse-MCP

智能体遍历本地图，精确定位缺乏覆盖的逻辑分支。它不是猜测输入，而是精确看到哪些边缘情况暴露在外（“validate_checkout() 中的失败状态完全未测试”），并编写真正验证系统的、有针对性的行为测试。

常见问题解答

常见问题

关于 Synapse MCP、设置说明以及优化 AI 编码智能体，您需要了解的一切。

什么是 Synapse MCP，它是如何工作的？

Synapse MCP 是一个持久的本地代码知识图谱服务器，通过模型上下文协议（MCP）运行。它不是强制您的 AI 智能体依赖字符串匹配 grep 或未压缩的文件读取，而是将您的整个代码库索引为 AST 块、调用边和语义嵌入。它通过一次工具调用提供 100% 准确的调用方/被调用方图和压缩的代码上下文。

Synapse MCP 图查询有多快？

Synapse 图查找在本地内存中执行，速度在微秒到纳秒级别。索引一个 10,000 文件仓库只需几秒，而在 Git 工作树中运行并行子智能体时，虚拟工作树覆盖（VWO）应用亚 50 毫秒的增量索引。

免费版和专业版有什么区别？

• 免费版（“黄金图” — $0）： 完整的 AST 索引、3 种搜索模式（符号、正则、语义）、上下文检索（查找、解释、入职）、文件检查、标准写入以及无限仓库。
• 专业版（“影子图” — 每月 $19）： 包含免费版的所有功能，外加深度图探索（调用方/被调用方/循环）、编辑前安全包、带 linter 验证的模拟安全写入（write_safely 带 dry-run）、崩溃堆栈跟踪解析（resolve_stack）、测试质量分析（find_tests）、持久加密知识缓存以及无限仓库。

Synapse Pro 如何自我回本？

前沿模型 API 成本为每 1M 令牌 $3 到 $15。通过 SmartCrusher 压缩将提示词令牌消耗减少 30-60%，并用单轮微秒级图查找替换 5-10 次 grep+read 轮次，Synapse 每次会话在原始 API 支出上节省约 $0.25 到 $0.50，在 48 小时的活跃开发内即可回本其每月 $19 的订阅费用。

Synapse 与简单的向量 RAG 或 RepoMix 文本转储有何不同？ Vector RAG 引擎按行数切分文件，把函数拦腰截断，还会漏掉导入的函数别名。RepoMix 将未压缩的 30,000 行文本文件直接塞进提示词，摧毁你的上下文窗口。Synapse 解析精确的编译器 AST 节点，构建传递调用者树，并在发送给 LLM 之前将负载压缩 30-60%。

Synapse MCP 为我的 AI 代理提供哪些能力？

Synapse 提供 13 个整合的 MCP 工具，涵盖：

• 探索与搜索： 语义搜索、符号查找、正则搜索，以及单轮传递调用者/被调用者图遍历。
• 上下文策展： 编辑前安全包、代码块解释、入门顺序，以及大纲签名扫描。
• 安全修改： 内存中的模拟文件写入，带自动 lint 验证和预演预检查。
• 影响与诊断： 亚 500ms 的调用者/被调用者影响映射（在编辑触及磁盘之前，向你的代理展示代码库中所有受影响的调用者）、崩溃堆栈跟踪解析为 AST 块、测试覆盖映射，以及循环检测。

如何安装和配置 Synapse MCP？

前往 下载 并为你的平台安装二进制文件——macOS 上是 .dmg，Windows 上是 .msi，Linux 上是 .deb。它会自动配置你的 IDE 或代理（Claude Code、Cursor、Antigravity、Windsurf、Cline、Zed、VS Code）。

“无法连接”/ ECONNREFUSED 127.0.0.1:8585 是什么意思？

这意味着你的编辑器尝试连接本地 Synapse MCP 服务器，但端口 8585 上没有服务在监听。Synapse 是一个本地 HTTP 服务；编辑器连接它，但不会为你启动它。Cursor 通常将此记录为 SSE error: fetch failed: connect ECONNREFUSED 127.0.0.1:8585。

使用 synapse-mcp start 启动它，然后通过 synapse-mcp enable 在未来的重启后保持其运行。在编辑器中重新加载 MCP 服务器（或重启编辑器）。使用 synapse-mcp status 检查状态。端点是 http://127.0.0.1:8585/mcp。

升级后如何激活 Pro？

结账成功后，刷新本地安装缓存的授权，以立即解锁 Pro。选择以下任一方式：

1. 按 打开 Synapse。
2. 或打开本地 Synapse 仪表板，在 用户 选项卡中按 刷新。
3. 或在终端中运行 synapse-mcp auth refresh。

为什么配置 AGENTS.md 或 SKILL.md 规则是强制性的？

前沿 LLM（Claude Sonnet 5、GPT-5.6 Sol、Gemini 3.6 Flash、Grok 4.5）在 Unix 命令示例上进行了大量预训练，形成了对 grep 和原始文件读取的强烈默认“肌肉记忆”。如果没有在代理的系统提示词中显式规则（例如 .agents/skills/synapse-mcp/SKILL.md 或 AGENTS.md），代理将默认使用标准 shell 命令并忽略 MCP 服务器。

运行 synapse-mcp install 会在检测到的代理配置路径（~/.gemini/config/AGENTS.md、~/.claude/CLAUDE.md、.cursorrules 等）中自动注册 MCP 优先发现策略，以强制工具使用。

Synapse MCP 会将我的代码库发送到云端吗？

不会。Synapse MCP 完全在本地机器上作为 stdio/HTTP 进程运行。所有 AST 索引、图存储、SQLite 持久化和嵌入计算都在本地进行。你的源代码不会作为正常本地索引或搜索的一部分上传到 Myelix Labs。免费 Synapse 账户（邮箱、Google 登录或 GitHub 登录）用于仪表板访问、许可和设备激活——该账户与本地索引分开，不会接收你的源代码。

为什么需要账户，为什么用 Google 登录？

使用 Synapse MCP 需要免费 Synapse 账户。该账户支持 Web 仪表板、许可和设备激活，以便你在机器上授权本地 MCP 客户端。你可以使用邮箱和密码创建账户，或使用 Google 登录或 GitHub 登录。

Google 登录 是创建或访问账户的方式之一。Synapse 仅请求你的 Google 邮箱地址和基本身份信息，用于创建或登录你的 Synapse 账户、确认你的邮箱，并将设备批准和订阅关联到正确的用户。我们不会请求访问 Gmail、Drive、Contacts 或其他 Google 服务，也不会使用 Google 登录来读取或上传你的代码库。

详情请参阅我们的 隐私政策。

为什么需要账户，为什么用 GitHub 登录？

使用 Synapse MCP 需要免费 Synapse 账户。该账户支持 Web 仪表板、许可和设备激活，以便你在机器上授权本地 MCP 客户端。你可以使用邮箱和密码创建账户，或使用 Google 登录或 GitHub 登录。

GitHub 登录 是创建或访问账户的方式之一。Synapse 仅请求你的 GitHub 邮箱地址和基本身份信息，用于创建或登录你的 Synapse 账户、确认你的邮箱，并将设备批准和订阅关联到正确的用户。我们不会请求访问你的仓库、组织或其他 GitHub 数据，也不会使用 GitHub 登录来读取或上传你的代码库。

详情请参阅我们的 隐私政策。

Synapse MCP 是否兼容多应用伞形仓库和 Git worktrees？

是的。Synapse 透明地检测 Git worktrees，并应用虚拟 worktree 覆盖层（VWO），实现近乎即时的增量索引（<50ms），允许多个子代理在并行 worktree 中操作，而无需重复图索引。

文章与研发

最新工程洞察

深入探讨 LLM 上下文优化、基于图的代码检索和代理工作流。

研究与洞察

AI 代理如何花你的钱？（以及 Synapse MCP 如何省钱）

一篇研究论文揭示，代理式编码任务消耗的 token 量是标准代码推理的 1,000 倍。我们剖析了原因——以及 Synapse MCP 的精准检索、AST 大纲器和 SmartCrusher 如何逐一解决根本原因。

架构

为什么 Synapse MCP 胜过原生 IDE 索引器（Cursor、Windsurf、Warp）

一篇架构深度剖析，解释为什么 Synapse MCP 的本地 AST 图和零延迟文件事件胜过 Cursor 和 Windsurf 使用的基于云的 RAG 和 Merkle 树。

基准测试

2ms 对比 12 秒：基准测试证明 AI 代理需要 AST 图，而非 Grep 链

一项实证“展示而非讲述”基准测试，比较传统 shell grep 循环与 Synapse MCP 的本地内存 AST 图引擎。2ms 延迟对比 12s，节省 56.4% token，减少 85% 工具调用。

行业洞察

2026 年 AI 开发者工具格局：为什么 Synapse Pro 是 $19/月

对 Cursor、Windsurf、Devin、Warp Terminal、Claude Pro 和 Synapse 的全面分析。为什么 $20/月 是普遍的价格锚点，以及 Synapse 如何自我回本。

技术研发

为什么 LLM 使用知识图谱编码更好——面向前沿 AI 代理的 AST 对比 Grep

来自我们研发的真实数据：如何用 AST 支持的调用者/被调用者图替换盲目的 grep/read 循环，节省 30-60% 的上下文 token，消除虚假信心，并解决多应用重构问题。

最佳实践

别再让 AI 幻觉重构——Synapse 如何消除重复发现

为什么标准 AI 代理浪费 70% 的会话时间重新读取文件，以及本地 AST 调用者图如何消除发现循环，实现零破坏重构。

架构与工程

本地代码知识图谱如何工作——微秒级 BEAM 引擎内部

Synapse MCP 如何使用 ETS、每仓库 GenServer 监督、纯 Elixir BM25F 嵌入，以及内存 Shadow Graph 安全写入，为 AI 代理提供 BEAM 上的微秒级代码库上下文。

基准测试

我们运行了三臂基准测试。我们在每次查询 token 上输了。以下是我们仍然获胜的原因。

我们在同一台机器上安装了 shell 工具、Synapse MCP 和 codebase-memory-mcp，索引了相同的代码库，并运行了五个相同的查询。我们在每次查询 token 数上输了。我们仍然发布结果——以下是总会话成本才是关键的原因。

基准测试

Synapse MCP 对比 Graphify——实时正面基准测试

我们在同一台机器上安装了这两个工具，索引了相同的代码库（包括 Linux 内核），并运行了相同的查询。Synapse 在每个维度上都更快、更精简、更安全。完整结果、原始计时、token 数。

架构

Karpathy 的 LLM Wiki 对比 Synapse MCP：为什么代码需要图，而非散文

Andrej Karpathy 的 LLM Wiki gist 对散文来说很出色——但代码不是散文。应用于代码库时，wiki 模式会与一个活生生的、结构化的工件发生冲突。以下是持久代码图——而非摘要文件夹——才是正确工具的原因，以及每个权衡背后的诚实推理。

基准测试

图漂移问题是真实的。Graphify 仍然无法解决它。

一篇 Medium 文章描述了完全正确的场景——一个代理针对三周前的知识图谱进行重构——然后开出处方是添加可观测性钩子，而不是修复保证漂移的架构。我们运行了基准测试。以下是为什么没有任何钩子能修复实时内存图所预防的问题。

对比

Synapse 如何对比

同一硬件上的实时基准测试。不是营销声明——是在 torvalds/linux 上、74,619 个文件下的真实测量。

特性	Synapse MCP	Graphify	Sourcegraph	Greptile
架构	BEAM · ETS · 持久守护进程	Python · NetworkX · 无守护进程	Go · Zoekt · SaaS	Vector RAG · 云
查询速度	亚毫秒 · Linux 内核 148ms	59.3s 冷启动（1.6 GB JSON）	~100ms 搜索	~500ms 向量
写入安全	✓ Shadow Graph 在写入磁盘前验证	✗ 只读	✗ 仅搜索	✗ 仅搜索
死代码决策	✓ safe_to_delete + 置信度	列出零调用者函数	✗	✗
崩溃解析	✓ resolve_stack 映射到 AST	✗	✗	✗
Token 压缩	✓ SmartCrusher 30-60%	✗	✗	✗
Linux 内核 RAM	877 MB	5.21 GB	—	—
隐私	✓ 100% 本地 · 零云	SaaS 云上传	SaaS/自托管	仅云
定价	免费 · Pro $19/月	免费 · Pro $10/月	免费 · 企业版	免费 · Pro $24/月