Gentleman-Programming/engram

项目概览

作为零依赖的单一 Go 二进制文件，engram 将 AI 记忆存储在本地 SQLite 中并暴露 20 个 MCP 工具，任何支持 MCP 的代理均可接入。它提供自动化的代理配置、基于 Git 的跨机器同步以及可选的云端团队复制功能。

项目类型

MCP · RAG 与知识库 · 基础设施

应用场景

知识问答 · 编程开发

部署方式

查看项目说明

License

MIT

适合谁

• 需要在本地跨会话保留上下文的 AI 编码代理用户。
• 使用 MCP 兼容代理（如 Claude Code、Cursor 等）并寻求零依赖本地记忆方案的开发者。

核心能力

• 通过 stdio 传输协议提供 20 个记忆管理工具，兼容任何支持 MCP 的代理。
• 将代理记忆持久化到本地 SQLite 数据库，并使用 FTS5 进行全文搜索索引。
• 提供本地 HTTP REST API，用于会话跟踪和记忆管理。
• 提供用于保存、搜索、导出和管理记忆的命令行界面。
• 提供交互式终端仪表盘，用于浏览和搜索记忆。
• 使用压缩块在机器间共享记忆，且不会产生合并冲突。
• 将本地记忆复制到共享云实例，以便团队进行访问。
• 检测冲突的架构记忆，并使用 LLM 推理进行语义相似度检查。

限制与风险

• MCP 传输仅支持 stdio，不提供 HTTP 或网络 MCP 端点。
• HTTP API 仅绑定到 127.0.0.1，容器内的服务在未经配置的情况下无法直接访问。
• 语义扫描无法独立发现在词法上完全不相关的记忆对。
• 可能发生可修复的云端同步、upsert 或规范化失败，需要执行明确的 doctor 或 repair 流程。

如何开始

• 安装难度较低，可通过 Homebrew 一条命令安装，并使用自动化代理设置命令完成初始化。

替代方案与同类比较

• nduckmink/arkon 是一个自托管的企业知识管理层和 MCP 服务器，它将组织文档编译成具有角色管控的结构化 wiki，而非为单个代理提供跨会话记忆持久化。
• victoriametrics/mcp-victoriametrics 提供只读的 PromQL/MetricsQL 查询等监控工具，服务于可观测性场景，不提供用于存储对话上下文的记忆持久化能力。
• butterbase-ai/butterbase 提供用于构建 AI 应用的完整后端积木（包含 Postgres、函数和 RAG），其内置的 MCP 服务器用于操作后端，而非聚焦于解决代理记忆遗忘问题。

同类比较

• Gentleman-Programming/engram vs 面向组织知识的 MCP 服务器
• Gentleman-Programming/engram vs 监控数据查询 MCP 服务器
• Gentleman-Programming/engram vs 提供内置 MCP 的后端平台

核验依据

• README: A **Go binary** with SQLite + FTS5 full-text search, exposed via CLI, HTTP API, MCP server, and an interactive TUI. Works with **any agent** that supports MCP
• README: What `engram setup` does — it writes MCP config and plugin files for the chosen agent. After setup, restart your agent and it is ready. No server to start manually.
• README: `engram serve` is only needed when a plugin uses the HTTP API for session tracking
• README: Full tool reference with parameters → [DOCS.md#mcp-tools-20-tools](DOCS.md#mcp-tools-20-tools)
• README: Agent calls mem_save → title, type, What/Why/Where/Learned 3. Engram persists to SQLite with FTS5 indexing 4. Next session: agent searches memory, gets relevant context

来源更新时间：2026-07-26T00:59:27Z

打开原始 GitHub 项目