# @engramlabs/mcp 中文文档

规范地址：https://npmcn.com/package/%40engramlabs/mcp/

版本：0\.6\.1
npm 元数据更新时间：2026-11-05T00:24:49.636Z
中文译文更新时间：2026-11-13T17:28:08.973Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40engramlabs/mcp
原文对照：https://npmcn.com/package/%40engramlabs/mcp/?lang=original
项目主页：https://github.com/phanijapps/engram#readme
源码仓库：https://github.com/phanijapps/engram

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：548 kB，135 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-18T20:15:53.660Z
- 最新版本发布：2026-11-05T00:24:49.237Z
- 近 30 天下载量：5404（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 30 个）

## 中文简介

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

## 安装

```sh
npm install @engramlabs/mcp
```

也可以使用：`pnpm add @engramlabs/mcp`、`yarn add @engramlabs/mcp`、`bun add @engramlabs/mcp`

## README

# @engramlabs/ mcp (英语)

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

## 安装

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

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

## 启动时选择嵌入

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

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

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

不嵌入配置客户端 :

```sh
engram-mcp install --client claude --slim
```

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

## 分行编码索引

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

```sh
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` 以保持索引的时序.

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

```sh
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
```

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

## 肿瘤包

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

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

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

```sh
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`) (中文(简体) ). 不需要包;默认的技术/领域/业务 肿瘤船内建.

## 可选代理工作流程

```sh
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` - 运行 它来自应携带它们的还原物, 并期望这种副作用在任何 重新开始你站在那里。 见 [设置指南](https://github.com/phanijapps/engram/blob/main/mcp/engram-mcp/HOW-TO.md)。 。 。 .

## 平台和配置

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

关于远程嵌入、模型缓存和安全模型变化,见 [配置](https://github.com/phanijapps/engram/blob/main/packages/launcher/CONFIGURATION.md)。 。 。 .

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

[GitHub 图像](https://github.com/phanijapps/engram) 麻省理工学院

## 常见问题

### @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 和提交记录判断。