← 返回目录

DreamGraph

社区

基于图治理的架构认知层，为 MCP 软件项目提供可审计的执行。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 147 / 438
Stars: ★ 126 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 3 天前

58FMRS · C

DreamGraph 是一个复杂、功能丰富的 MCP 服务器，提供基于图的架构认知。它适合需要持久记忆和架构治理的成长型项目，但学习曲线陡峭。建议在隔离环境中试用，并注意安全配置。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

8/20

维护活跃度

14/20

文档质量

16/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 证据：仓库包含大量 TypeScript 源码，并有 package.json、tsconfig 等标准 Node.js 项目结构，表明可构建和运行。README 明确说明了启动命令（npm run build、node dist/index.js），且有 src/server 和 src/tools 目录，暗示 MCP 服务器实现存在。但未提供 CI 工作流或测试文件的直接证据，已声明的工具功能未经执行验证，错误处理和依赖管理细节不明，故可靠性得分受限。
安全与权限 8/20: 证据：仓库声明为 source-available 许可，且包含 security-scanner 主题，暗示存在安全相关工具。未发现代码中存在明显的恶意行为、凭据窃取或数据外泄迹象。然而，权限模型、数据边界、外部网络行为及危险操作的确认机制在静态审查中不够清晰，无法确认是否遵循最低权限原则。因此安全性得分适中。
维护活跃度 14/20: 证据：仓库最近有 v12.6.0 发布，且版本历史丰富，表明持续维护。有明确的许可证和赞助机制，体现了项目所有权。但开放问题数为 0，可能是未启用问题追踪或未公开讨论，依赖更新路径和漏洞响应渠道未见明确说明，故扣分。
文档质量 16/20: 证据：README 非常详细，包含安装、快速上手、架构说明和文档链接，并配有用户指南和自动生成的参考文档。文档质量高，提供了分层文档（指南、参考、故障排查）。但某些部分如许可条款、具体工具参数和成本说明，需查阅外部文档，未完全内嵌在 README 中，故未给满分。
安装易用性 12/20: 证据：提供了 Windows 和 Linux/macOS 的明确安装脚本，并给出逐步 CLI 命令，说明安装路径清晰。但未提供主流 MCP 客户端（如 Claude Desktop、Cursor）的具体配置示例，且需要 Node.js 20+ 和额外组件，安装步骤相对复杂。静态审查无执行证据，但安装脚本提供了一致性线索，故 setup 得分不超过 15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码连接数据库

适合谁

开发人员其代码库超出短期记忆，需要 AI 帮助理解系统、解释变更并证明建议值得信赖。
架构师、系统工程师和产品构建者需要架构智能层。
使用 MCP 客户端（如 Claude Desktop 或 VS Code）的项目，并希望持久图记忆。

不适合谁

寻找轻量级聊天助手而非复杂知识图系统的用户。
偏好无需持久状态或架构治理的简单工具的项目。
没有 Node.js 20+ 或兼容 shell 的环境。

所需权限

读取项目文件以构建知识图谱（扫描、充实）。
读取和写入实例配置和数据库（默认 SQLite，可选 PostgreSQL）。
执行 `dg` CLI 命令来管理守护进程生命周期。
VS Code 扩展权限：文件访问、编辑器集成、守护进程连接。
潜在的网络访问（通过 HTTP 守护进程）和 LLM API 或本地模型服务器连接。

风险与副作用

认知输出是建议性的，直到由治理证据或显式审查支持；过期或被拒绝的想法保持可检查但并不权威。
确保实例配置安全，特别是在使用 HTTP 传输时；守护进程不应暴露在不受信任的网络中。
插件（在选项中启用）必须获得信任；不受信任的插件可能带来风险，但机制支持门控和信任横幅。
升级前备份数据，以防需要迁移脚本（例如 v8.2.6 之前的版本）。

安装接入

准备工作

运行环境：Node.js 20+

DATABASE_URL 可选密钥 PostgreSQL 等数据库连接串，用于 Datastore-as-Hub 的实时 schema 内省（scan_database）；未设置时该功能不生效。

其他可选配置项（1 个）

DG_ALLOW_INPROCESS_PLUGINS 可选设为 true 以启用进程内插件运行时，还需在 instance. 中为每个插件设置 trusted: true。

从源码安装：

克隆仓库：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 启动守护进程。

验证是否装好

运行 dg init 创建实例并用 dg start my-project --http 启动守护进程，然后执行 dg status my-project；若显示实例身份、传输/端口及图谱/ADR 计数，即说明安装成功。在 MCP 客户端中以 stdio 模式（dg start my-project --foreground）连接后，工具列表应出现 DreamGraph 的图谱查询工具。

常见排障

确认 Node.js 20+ 和 npm 已安装：`node --version`、`npm --version`。
检查守护进程状态：`dg status my-project`，确保端口可用且未被占用。
如果连接问题，重启守护进程并重新加载 VS Code 窗口。
对于 LLM 设置，验证环境变量（如 Ollama/LM Studio URL）已正确配置。
如果无法连接，检查防火墙或代理设置。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

扫描这个仓库并构建知识图谱
auth 到底在哪里发生？
如果我修改这个模块会破坏什么？
当前实例的状态是什么？

使用场景

理解大型代码库：提问‘认证在哪里真正发生？’、‘如果更改此模块会破坏什么？’

使大型更改更安全：使用图上下文、ADR、工具轨迹和跨仓库感知。

在气氛编码和严肃工程之间架起桥梁：快速原型同时积累结构、来源和生命周期历史。

多仓库系统：跨共享工作流、API、数据库和所有权的仓库构建图链接。

架构师工作：项目绑定聊天、选定计划范围、运行时出处和可审计工具轨迹。

支持客户端

Claude Desktop

VS Code

依据项目文档列出，未经本站实测。

详细介绍

DreamGraph 是一个图治理的架构认知层，面向支持 MCP 的软件项目。它结合了实例级守护进程、CLI、架构师（测试版）、VS Code 扩展、仪表盘和持久知识图谱，使项目理解植根于源码、架构决策记录（ADR）、工作流、测试、运行观察和人工审查，而非单一文件读取或孤立聊天。它建立功能、工作流、数据模型实体、架构决策、UI 注册表、紧张关系和候选项的结构化图谱，支持跨仓库推理、实时数据库模式内省、梦周期、时间/因果分析和自适应未来引擎。