适合谁
- 需要超越搜索的答案（综合+缺口分析）的个人知识管理
- 希望建立团队共享记忆的组织（需OAuth范围控制）
- 需要持久记忆的AI代理（自动摄取、丰富、固化）
G
66FMRS · C
GBrain是一个功能丰富的知识图谱和RAG引擎，提供独特的综合和缺口分析能力。它适合希望增强AI代理记忆的个人和团队，但需要一定技术背景来部署和配置。安全性方面，本地存储和多用户隔离设计良好，但需注意API密钥和令牌的安全。安装时务必从GitHub获取，避免npm包混淆。总体而言，对于需要真正“大脑”而非搜索的工具，这是一个强大的选择。
GBrain 是一个开源的知识图谱与检索增强生成（RAG）引擎，由 Y Combinator 总裁 Garry Tan 开发，用于驱动他自己的 AI 代理。它提供混合搜索（向量+关键词+重排序）、自我构建的知识图谱以及综合层（think），可直接返回带引用的答案并指出知识缺口。它支持个人使用或作为团队的公司大脑，通过 OAuth 和范围控制实现多用户隔离。它可通过命令行、MCP（stdio/HTTP）或集成到 Claude Code、Codex、Cursor 等客户端中使用。它使用 PGLite（零配置）或 Postgres + pgvector 作为后端。
工具能力
search
混合检索，返回按分数排序的原始页面列表。
think
综合检索结果，生成带引用的答案和知识缺口分析。
put_page
写入页面并自动提取实体关系（零LLM调用）。
graph-query
执行多跳知识图谱查询。
schema_apply_mutations
批量应用模式变更（管理员权限，远程可用）。
capture
捕获想法或文件内容为页面。
agent
通过任务队列运行子代理，执行思考操作。
sync
同步数据源（如导入、同步）。
import
导入文件或目录到大脑。
query
执行检索或综合查询（别名）。
安装接入
安装步骤：1. 安装 Bun 运行时。2. 运行 bun install -g github:garrytan/gbrain（注意：npm 上的 gbrain 包无关，不要使用）。3. 初始化本地大脑：gbrain init --pglite。4. 验证安装：gbrain doctor。5. 将 MCP 服务器连接到客户端：例如 Claude Code 使用 claude mcp add gbrain -- gbrain serve；或者远程使用 gbrain connect https://your-host/mcp --token gbrain_xxx --install。
选型与风险
不适合谁
- 需要严格实时数据流的场景（依赖定时同步和爬取）
- 没有API密钥或不想配置嵌入模型的用户（需要至少一个嵌入提供商）
- 需要云托管服务的用户（需要自行部署）
所需权限
- 读取和写入本地文件系统（用于大脑仓库和导入）
- 网络访问外部API（解锁嵌入提供商、LLM、摄取Webhook）
- 环境变量访问API密钥（如OPENAI_API_KEY等）
- 本地数据库（PGLite或Postgres）
风险与副作用
- 安装包混淆：npm上的`gbrain`包无关，可能导致冲突，需仅从GitHub安装
- 数据隐私：本地数据安全，但远程部署时需保护OAuth令牌和API密钥
- LLM成本：`think`和综合功能消耗LLM API调用，可能产生费用
- 性能问题：大型大脑同步可能耗时或卡顿（已提供故障排除）
常见排障
- `gbrain init --pglite` 在macOS 26.x上崩溃：使用原生Homebrew PostgreSQL + pgvector
- `gbrain import` 报维度错误：运行`gbrain doctor`并按照修复命令操作
- 定时同步超时：使用 `--break-lock --all --max-age` 和按源同步循环
- 梦周期丢失链接：升级到v0.41.19.0+并使用重试环境变量
- PGLite单写者冲突：大型同步时先停止`gbrain serve`
使用场景
在会议前获取关于某个人的综合摘要（如“与Alice开会前需要了解什么”）
查询知识图谱中的关系（如“谁在Acme AI工作？”）
作为团队的共享机构记忆，按登录隔离（公司大脑）
为编码代理提供长期记忆，避免忘记非代码上下文
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Codex完整支持
Cursor完整支持
Windsurf完整支持
Perplexity完整支持
ChatGPT完整支持
Claude Cowork完整支持