适合谁
- 开发人员其代码库超出短期记忆，需要 AI 帮助理解系统、解释变更并证明建议值得信赖。
- 架构师、系统工程师和产品构建者需要架构智能层。
- 使用 MCP 客户端（如 Claude Desktop 或 VS Code）的项目，并希望持久图记忆。
D
58FMRS · C
DreamGraph 是一个复杂、功能丰富的 MCP 服务器，提供基于图的架构认知。它适合需要持久记忆和架构治理的成长型项目，但学习曲线陡峭。建议在隔离环境中试用，并注意安全配置。
DreamGraph 是一个图治理的架构认知层，面向支持 MCP 的软件项目。它结合了实例级守护进程、CLI、架构师（测试版）、VS Code 扩展、仪表盘和持久知识图谱，使项目理解植根于源码、架构决策记录（ADR）、工作流、测试、运行观察和人工审查，而非单一文件读取或孤立聊天。它建立功能、工作流、数据模型实体、架构决策、UI 注册表、紧张关系和候选项的结构化图谱，支持跨仓库推理、实时数据库模式内省、梦周期、时间/因果分析和自适应未来引擎。
工具能力
暂未整理工具清单。
安装接入
从源码安装：
- 克隆仓库：
git clone https://github.com/mmethodz/dreamgraph.git - 进入目录：
cd dreamgraph - 运行安装脚本：
- Windows PowerShell：./scripts/install.ps1 -Force
- Linux/macOS Bash：bash scripts/install.sh --force
- 或者手动构建：
npm install和npm run build。 - 使用
dg init创建实例，使用dg start my-project --foreground以 stdio 或--http启动守护进程。
选型与风险
不适合谁
- 寻找轻量级聊天助手而非复杂知识图系统的用户。
- 偏好无需持久状态或架构治理的简单工具的项目。
- 没有 Node.js 20+ 或兼容 shell 的环境。
所需权限
- 读取项目文件以构建知识图谱（扫描、充实）。
- 读取和写入实例配置和数据库（默认 SQLite，可选 PostgreSQL）。
- 执行 `dg` CLI 命令来管理守护进程生命周期。
- VS Code 扩展权限：文件访问、编辑器集成、守护进程连接。
- 潜在的网络访问（通过 HTTP 守护进程）和 LLM API 或本地模型服务器连接。
风险与副作用
- 认知输出是建议性的，直到由治理证据或显式审查支持；过期或被拒绝的想法保持可检查但并不权威。
- 确保实例配置安全，特别是在使用 HTTP 传输时；守护进程不应暴露在不受信任的网络中。
- 插件（在选项中启用）必须获得信任；不受信任的插件可能带来风险，但机制支持门控和信任横幅。
- 升级前备份数据，以防需要迁移脚本（例如 v8.2.6 之前的版本）。
常见排障
- 确认 Node.js 20+ 和 npm 已安装：`node --version`、`npm --version`。
- 检查守护进程状态：`dg status my-project`，确保端口可用且未被占用。
- 如果连接问题，重启守护进程并重新加载 VS Code 窗口。
- 对于 LLM 设置，验证环境变量（如 Ollama/LM Studio URL）已正确配置。
- 如果无法连接，检查防火墙或代理设置。
使用场景
理解大型代码库：提问‘认证在哪里真正发生？’、‘如果更改此模块会破坏什么？’
使大型更改更安全：使用图上下文、ADR、工具轨迹和跨仓库感知。
在气氛编码和严肃工程之间架起桥梁：快速原型同时积累结构、来源和生命周期历史。
多仓库系统：跨共享工作流、API、数据库和所有权的仓库构建图链接。
架构师工作：项目绑定聊天、选定计划范围、运行时出处和可审计工具轨迹。
支持客户端
Claude Desktop完整支持
VS Code完整支持