VS

vss96/synapse

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

1 stars 0 forks 质量 78 趋势 16MIT

Synapse – 适用于任何代理的实时计划、代码与心理模型 MCP 服务器

概览

是一个MCP服务器+实时网页查看器,允许(Claude代码、Claude桌面、光标、OpenCode、Codex、Windsurf等)维护实时可视化思维导图,内容包括:1. (具有计划、计划、in_progress、完成和阻塞状态的层级任务)2.(语义组件、data_flow、决策、假设和风险卡,通过有向流程链接连接)3. (线区间、符号、差分摘要及计划任务与架构组件之间的交叉高亮) init 检测 Claude Code、Claude Desktop、Cursor、OpenCode 和 Codex(也包括 ChatGPT 桌面应用),在配置前询问,并备份它编辑的配置文件。之后重启你的代理。思维导图存储在 ~/.synapse/data(用 SYNAPSE_DATA_DIR 覆盖)。请参见客户端指南中的手动设置。

概述(AI 翻译)

Synapse 是一个 MCP 服务器 + 实时网页查看器,允许任何编码代理(Claude Code、Claude Desktop、Cursor、OpenCode、Codex、Windsurf 等)维护一个实时可视化思维导图:

  1. 计划是什么(具有planned]、in_progress、completed和blocked状态的分层任务)
  2. 智能体如何思考代码(HLD / 心理模型)(语义上的component、data_flow、decision、hypothesis和[risk卡,通过有向流链连接)
  3. 正在处理哪些文件和符号(线区间、符号、差分摘要以及平面任务与建筑组件之间的交叉高亮)

📖 文档: https://vss96.github.io/synapse/

快速启动

需要节点20≥。

init 检测 Claude Code、Claude Desktop、Cursor、OpenCode 和 Codex(也涵盖 ChatGPT 桌面应用),在配置前询问每个程序,并备份其编辑的配置文件。之后重启您的代理。思维导图存储在 ~/.synapse/data](用 SYNAPSE_DATA_DIR 覆盖)。请参见客户端指南,了解如何手动设置和更新以获取新版本。


截图

1.代码心理模型与高层设计(HLD)视图

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Synapse – Live Plan, Code & Mental Model Mindmap for Any Agent

Synapse is an MCP server + live web viewer that lets any coding agent (Claude Code, Claude Desktop, Cursor, OpenCode, Codex, Windsurf, etc.) maintain a real-time visual mindmap of:

  1. What the plan is (hierarchical tasks with planned, in_progress, completed, and blocked statuses)
  2. How the agent is thinking about the code (HLD / Mental Model) (semantic component, data_flow, decision, hypothesis, and risk cards connected by directed flow links)
  3. Which files and symbols are being touched (line ranges, symbols, diff summaries, and cross-highlighting between plan tasks and architectural components)

📖 Docs: https://vss96.github.io/synapse/

Quick Start

Requires Node ≥ 20.

# Register Synapse with the coding agents installed on this machine
npx synapse-mindmap init

# Watch your agent work (port 4040, or the next free port)
npx synapse-mindmap viewer --open

init detects Claude Code, Claude Desktop, Cursor, OpenCode and Codex (which also covers the ChatGPT desktop app), asks before configuring each one, and backs up any config file it edits. Restart your agent afterwards. Mindmaps are stored in ~/.synapse/data (override with SYNAPSE_DATA_DIR). See the client guide for manual setup, and Updating for getting new releases.


Screenshots

1. Code Mental Model & High-Level Design (HLD) View

Visualize how the agent understands the system architecture, data flows, design decisions, hypotheses, and risks—without reading walls of text:

2. Split View (Plan Tree + Code Mental Model)

See the full execution plan and the architectural mental model side-by-side in a single live canvas. The Sessions panel on the left lists every mindmap with its active task, progress, and a live dot; filter it or switch with ⌥↑/⌥↓. Press / to find a card, file or symbol on the map:

3. Plan & Tasks View + Changes Tab

The Changes tab shows what kind of change the agent made in each file (added, modified, fixed, refactored, renamed, removed, tested). Pick a kind to highlight every plan task and HLD component with that kind of change:

4. Live Activity Stream

Track a real-time chronological log of every plan update, HLD mapping, and file edit:

5. Archiving Sessions

在 GitHub 查看完整 README

安装

npx -y synapse-mindmap mcp
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "synapse": { "command": "npx", "args": ["-y", "synapse-mindmap", "mcp"] } } }