@engramlabs/mcp

中文文档
0.6.1发布于 2026/11/05MIT零依赖构建来源已验证近 30 天下载 5404

本地第一代理内存:Engram MCP服务器发射器. 记忆 + 知识图 + 信仰 + 代码智能,用于任何MCP客户端.

中文使用文档
文档目录7 节
  1. 安装
  2. 启动时选择嵌入
  3. 分行编码索引
  4. 代码重置( 破坏性—— 需要所有者大门)
  5. 肿瘤包
  6. 可选代理工作流程
  7. 平台和配置

@engramlabs/ mcp (英语)

本地第一内存,对AI代理的知识和代码检索,通过MCP. 记住决定,搜索文档, 和导航代码关系在一个商店.

安装

npm install -g @engramlabs/mcp
engram-mcp install --client claude

其他客户: claude-desktop, (中文(简体) ), cursor, (中文(简体) ), codex, (中文(简体) ), pi, (中文(简体) ), copilot。 。 。 . 安装者注册已安装的软件包版本并默认存储到 ~/.engram。注册后重新启动您的 MCP 客户端.

启动时选择嵌入

一个安装, 没有版本或额外软件包 :

engram-mcp --storage ~/.engram          # Local embeddings enabled
engram-mcp --storage ~/.engram --slim   # Embeddings off

本地嵌入可能在第一次发射时下载模型资产;然后推断 运行在你的机器上. --slim 跳过嵌入设置和下载。 记忆, 知识、词汇和图表特征依然存在,但搜索排名可能有所不同. 它改变运行时的行为,而不是安装大小.

不嵌入配置客户端 :

engram-mcp install --client claude --slim

重新启动切换模式,保留相同的存储路径和项目. 内容 使用 MCP 嵌入时添加 reindex 工具.

分行编码索引

代码索引被固定在 犬科分支 (默认) refs/heads/main, (中文(简体) ), 而不是你的退货。 索引读取绑定分支的已承诺字节; a 肮脏的工作树 或同事的特征分支 永远不会污染 指数。 每个分支一个 (project, repository)。 。 。 .

engram-mcp code --op register --repo myrepo --path /abs/path/to/repo --json
engram-mcp code --op bind    --repo myrepo --branch-ref refs/heads/main --json
engram-mcp code --op rebuild --repo myrepo --request-id <unique-key> --json
engram-mcp code --op status  --repo myrepo --json
engram-mcp code --op refresh --repo myrepo --json

读取工具( E)search, (中文(简体) ), recall, (中文(简体) ), fetch_content, (中文(简体) ), symbol_context荣誉 自动绑定——永远不要通过分支来读取工具. fetch_content 返回已承诺的字节精确内容( sha256- 校验了 ) 修订),即使文件是脏的或本地删除的.

每次合并到主机后 : refresh 接下来 rebuild 以保持索引的时序.

代码重置( 破坏性—— 需要所有者大门)

engram-mcp code --op reset-preview --repo myrepo --json > preview.json
# Show the owner: target count, ambiguity list, preservation inventory.
# Get an explicit go-ahead, then:
engram-mcp code --op reset-apply --journal "$(cat preview.json)" --decision "<owner-gate>" --json

模糊的遗产目标 阻碍预览。 普通记忆和知识 从未被代码重置所触动 .

肿瘤包

将知识分类于 常设域名词汇 - 不是临时标签. 发射时插入肿瘤学和分类学,或安装标准域包:

engram-mcp --storage ~/.engram --project myproject \
  --ontology ~/.engram/myproject-ontology.json \
  --taxonomy ~/.engram/myproject-taxonomy.json

标准域包(33个被钉住:FIBO用于银行业务,schema.org用于旅行, 保健、物流和另外29个:

engram-mcp pack list                          # browse the catalogue
engram-mcp pack install fibo --storage ~/.engram --project banking
engram-mcp pack status --storage ~/.engram

安装的软件包添加词汇层 engram-distill 技术 分类——抽取的实体、关系和事实类型 与包的现实世界词汇(例如银行) Loan,而不是一个 常规 Concept) (中文(简体) ). 不需要包;默认的技术/领域/业务 肿瘤船内建.

可选代理工作流程

engram-mcp install --agent claude

加入技能,钩子,审查工作流程,以及工厂专家分剂. 技能集取自包在构建时间的作者树—— 目前为八: engram-index, (中文(简体) ), engram-know, (中文(简体) ), engram-mem, (中文(简体) ), engram-distill, (中文(简体) ), engram-bound (处式指数寿命周期), outcome-reporting,加上软件构件对 engram-factory 财务报告和审定财务报表 engram-frame在不改变安装器的情况下,新技能流入交付; 旧安装的退休技能自动删除,除非您 换了他们 卸载为 engram-mcp install --agent <host> --remove - 删除是标记名称,所以您自己替换或添加的文件是留下的 无所未有. engram-factory 还提供14个专家副剂 每个宿主的本土方言(claude,codex,副驾驶,pi). 使用 --scope project 用于仓库安装。 副驾驶是用户的例外 范围:该平台只发现每个存储器的代理,所以 install --agent copilot 撰写其15个代理文件(14名专家加 red-forman.md,刷新复制 携带我们的名字标记) 当前仓库 .github/agents/ 即使是与 --scope user - 运行 它来自应携带它们的还原物, 并期望这种副作用在任何 重新开始你站在那里。 见 设置指南。 。 。 .

平台和配置

预建二进制:Linux x64/ARM64 (glibc),macOS Apple Silicon,Windows x64. 其他平台需要建立源.

关于远程嵌入、模型缓存和安全模型变化,见 配置。 。 。 .

数据保留在您选择的存储目录中 。 没有遥测。 局部推论 不需要嵌入服务; 配置远程提供者发送嵌入 为这项服务提供投入.

GitHub 图像 麻省理工学院

版本与发布记录

@engramlabs/mcp 共发布 30 个版本,首次发布于 2026/10/19;过去 12 个月发布了 30 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.1latest2026/11/058 天前
0.6.02026/11/0113 天前
0.5.02026/10/2717 天前
0.4.32026/10/2519 天前
0.4.22026/10/2519 天前
0.4.02026/10/2519 天前

其他发布通道:alpha → 0.3.1-alpha。

关于 @engramlabs/mcp 的常见问题

@engramlabs/mcp 是什么?

本地第一代理内存:Engram MCP服务器发射器. 记忆 + 知识图 + 信仰 + 代码智能,用于任何MCP客户端.

如何安装 @engramlabs/mcp?

在项目目录运行 npm install @engramlabs/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 engram-mcp,可以用 npx engram-mcp 直接运行。

@engramlabs/mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/engramlabs__mcp 是否存在。

@engramlabs/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@engramlabs/mcp 可以商用吗?

@engramlabs/mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@engramlabs/mcp 的下载量有多少?

根据 npm 官方下载统计,@engramlabs/mcp 在 2026/10/14 – 2026/11/12 这 30 天内被下载 5,404 次,日均约 180 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@engramlabs/mcp 还在维护吗?

最新版本 0.6.1 发布于 2026/11/05(8 天前);至今共发布 30 个版本,其中过去 12 个月发布了 30 个;首次发布于 2026/10/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。