# @ani-hq/engram-mcp 中文文档

规范地址：https://npmcn.com/package/%40ani-hq/engram-mcp/

版本：0\.8\.0
npm 元数据更新时间：2026-10-29T03:22:25.008Z
中文译文更新时间：2026-11-09T19:46:56.282Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：250 kB，18 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：1 个
- 首次发布：2026-09-08T13:00:25.256Z
- 最新版本发布：2026-10-29T03:22:24.784Z
- 近 30 天下载量：1769（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

一个命令 MCP 连接器和 estdio 代理软件

## 安装

```sh
npm install @ani-hq/engram-mcp
```

也可以使用：`pnpm add @ani-hq/engram-mcp`、`yarn add @ani-hq/engram-mcp`、`bun add @ani-hq/engram-mcp`

## README

# @ani-hq/engram-mcp (韩语)

一个指令的 MCP 调用连接器和 Stdio- to- HTTP 代理编码 .

## 连接此计算机

在您的终端运行 :

```bash
npx -y @ani-hq/engram-mcp@latest
```

它发现了克洛德代码, Codex, Cursor, OpenClaw, Hermes Agent, Amp 和 Devin CLI 并打开 你的浏览器。 检查代码匹配, 点击批准, 每个代理是 连接它自己的访问密钥。 Engram 然后在每个寄存器中工作 计算机:项目取自代理商正在工作的git仓库, 并且没有写入项目文件夹。 重新启动任何已经存在的代理 打开。 Codex 在运行新钩之前询问一次; 运行 `/hooks` 在编码和核准中 插图. 赫尔墨斯特工在运行新钩子之前也问过一次. 重新启动 OpenClaw网关可以装入 Engram 插件 .

为每个代理撰写的确切文件列于 [文件/出版物](https://github.com/Ani-HQ/engram/blob/main/docs/WIRING.md#primary-path)。 。 。 .

对于自动托管的服务器,请添加 `--host https://your-engram.example`。 。 。 .

## 代理设置

要设置一个代理或一个项目文件夹, 请指定代理 :

```bash
engram-mcp setup claude
engram-mcp setup codex
engram-mcp setup cursor --host https://engram.ani.computer
```

选择一个已有的工程文件夹、 一个简短的内存主题和 Engram 主机或 然后粘贴来自工作空间的访问符 **连接** 屏幕显示隐藏的提示。 符号不重复或包含 在您的命令历史中。 对特定项目文件夹绑定要优先 在电脑上.

在安装 MCP 之前设置检查活符身份和工具发现 连接和项目内存工作流程。 您不编辑 Mark down 或 配置文件 。 如果检查或配置飞行前失败, 则设置叶片 代理配置不变,并解释下一个动作。 终点必须 使用 HTTPS; HTTP 只能被接受为回回自托管服务器.

在成功时,设置会显示精确路径,备份已更改的现有文件,以及 更新 Engram 条目并管理内存钩/插件。 其他代理服务器和设置被保存. 配置 且备份文件对您的用户是私有的; 现有的仅所有者的权限是 ,当保存一个符号时,组/世界访问将被删除。 现有 保留备份。 符号链接配置文件被拒绝, 所以一个符号不是 写入链接的点文件仓库.

Hook 代码被复制到私有版本的运行时间 `$XDG_DATA_HOME/engram-mcp/runtimes` (默认) `~/.local/share/engram-mcp/runtimes`) (中文(简体) ). 它继续工作,如果 `npx` 清除它的缓存。 没有启用记录夹 . 原生指导指该确切的可执行文件,其中引用了绝对命令; 决策、无变化和已知结果报告不需要全球 `engram-mcp` 二进制中 `PATH`。 。 。 . 设置每个目的地的飞行前, 以解剖方式执行文件, 并恢复文件 如果以后的写失败, 它会改变 。 保留同时进行的用户编辑 而不是在回收期间被覆盖.

更新内存工作流程后重新启动或重新装入您的代理 。 对于克洛德代码, 结算运行中的工作、退出和运行 `claude --continue` 在同一项目中 使用更新的钩子恢复。 仅刷新MCP并不能确认钩子 已装入。 代码仍然需要本地 钩检和信任通过 `/hooks`; 管理或残疾政策得到保留. 设置本身从不代表您读取或撰写回忆或报告任务. 运行一个真实的任务, 然后在 Connections 中审查检索/保存收件 . 访问检查和已安装的文件不能证明自动使用模型.

明确的内存可节省最多等15秒的收据;快速读取和 钩子检查保持他们的两秒网络最后期限. 超时报告为 未确认的保存, 而不是证明 Engram 已下线 。 桥只保留 尝试时间和诊断的限值失败代码,绝不自动 重放未经证实的内存 .

现有用户运行相同的命令,或 `engram-mcp upgrade <agent>`。现有 密钥仅用于同一端点,并在写入前再次检查. 保存一个没有被保存的无记名者的现有运行时间管理/操作连接; 设置安装软件包的项目技能而不是复制认证 或替换连接。 在这种模式下,CLI的进入仍然不受限制. 技能是模式选择的指导,没有硬性累积任务预算报销. 使用 `--portable` 在所支持的运行时间中明确选择技能工作流程. 技能默认为项目范围 。 代码用户可以选择 `engram-mcp upgrade codex --project . --skill-scope user` 安装一个已管理 个人技能 `~/.agents/skills/engram-memory/SKILL.md` 换句话说 此选择 便携式指导,使项目文件保持不变,并保留任何现有的 无人管理的技能。 自动用户范围目前只支持 Codex .

支持的地方目标 `claude`, (中文(简体) ), `codex`, (中文(简体) ), `cursor`, (中文(简体) ), `gemini`, (中文(简体) ), `vscode`, (中文(简体) ), `copilot` (驾驶员CLI), `opencode`, (中文(简体) ), `openclaw`,以及 `windsurf`设置 实际运行时间主机; Mac 安装不能配置云瓶。 Grok 瓶装 其自己的 Connect apps 和私人技能控制,而不是本地文件系统路径.

## 检查连接

```bash
engram-mcp doctor codex
engram-mcp doctor cursor
engram-mcp doctor --host https://engram.ani.computer
```

有个特工名字, `doctor` 读取该代理商的本地 HTTP 连接 用户配置。 没有它,它使用隐藏的符号提示或 `ENGRAM_TOKEN`。 。 。 . `verify` 是用于 `doctor`。这些命令只调用 `whoami` 财务报告和审定财务报表 `tools/list`中,不更改配置文件或缓存文件,也不读取存储的记忆 或写作。 成功发现证明现场身份和目录访问; 它不能证明您的代理人已经装入其配置, 或无法证明内存写入 工作空间政策或账单允许。 使用打印的测试提示 从代理 核实整个旅程.

单独的生命周期命令 `memory verify begin|status --run <known-run-id>` 启动或读取由服务器发行的明确工作流程检查。 开始检查 没有写入内存或任务报告; 真实的后期范围已读取并明确决定 保存在运行中提供收据。 15分钟后支票就过期了,从不 证明自动使用模型。 见 [内存生命周期](https://npmcn.com/package/%40ani-hq/docs/AGENT-MEMORY.md)。 。 。 .

## 切入内存生命周期

MCP访问本身并不能确保代理使用共享内存. 增加第0.5版 明确的项目范围生命周期桥:

```bash
engram-mcp memory install claude --project /absolute/project --topic "Project architecture"
engram-mcp memory doctor --project /absolute/project
```

安装验证访问、备份现有设置并增加轻量级 克劳德代码命令钩。 它为第一个实质性项目恢复目标背景 每个会话迅速, 重复整个重启/ 关联的呼叫, 并限制返回的内存 默认为每个任务4096 UTF-8字节(可配置至16384)。 决定和决定 只能通过明确的结构来节省分发 `memory decision` 事件. 没有记录记录,没有第二次模式呼叫,也没有每个消息的召回。 停车 通知从不标出已完成的任务。 操作失败不会阻碍工作. 后来的任务边界需要明确 `Engram task: <name>` 提示或记录 任务端; 任意的自然语言任务变化是不可靠的推断.

本地选入安装器也覆盖 `codex`, (中文(简体) ), `cursor` (桌面), `gemini`, (中文(简体) ), `copilot` (VS代码副驾驶运行时间/CLI), `opencode`, (中文(简体) ), `openclaw`,以及 `windsurf`。 。 。 . 运行 `engram-mcp memory capabilities <runtime>` 检查准确的地表 限制。 在实际运行时间主机上安装,然后重新装入. 风浪报告 仅限实际生命周期事件。 光标/ 辅助快捷钩不能注入上下文 直接;其适配器则使用有记录的起动/后工具输出.

没有经过认证的本地适配器的客户端可以导出可移植的MCP指导:

```bash
engram-mcp memory instructions goose
engram-mcp memory skill cline --output /absolute/review/engram-memory/SKILL.md
```

单是训导是最佳的。 原生HTTP MCP 呼叫收到每个响应 除非客户端发送任务元数据。 传播普通元数据 模型读取 **stdio 连接器**,明确设置 `ENGRAM_MEMORY_PROJECT=/actual/project` 在连接器上。 终点和证书 必须符合私人约束。 模糊的会议需要明确 `ENGRAM_MEMORY_SESSION_ID` 或拥有 `ENGRAM_MEMORY_RUN_ID`;否则就叫停 反应范围。 调用任务/ probe ID优先 。 见 [代理兼容性](https://github.com/Ani-HQ/engram/blob/main/docs/AGENT-COMPATIBILITY.md) 用于已执行的表面、固定检查和剩余的实际应用验证.

Grok Bot有一个包含技能的工作流程, 诚实的最好的状态:

```bash
engram-mcp memory instructions grokbot
engram-mcp memory skill grokbot --output /absolute/review/engram-memory/SKILL.md
```

审查并启用了Grok Bot的技能. 它的默认路径使用已有的 MCP 没有CLI或本地绑定的连接。 Plain MCP 有服务器的4096字节 每一次响应默认;累积任务预算需要客户上下文元数据或 桥。 技能仍然是最佳代理指导.

Grok Bot在一款持久的云计算机上工作. 安装在您的 Mac 上的 CLI 不配置云运行时间 。 只有在实际安装CLI时 代理运行时间,请使用 `memory install grokbot`。 。 。 . 不在聊天中提供证书 。 此可选安装器只写 运行时的私有 Engram 绑定; 它不编辑 Grok Bot 设置或安装 本土钩子. 拥有的运行时间可以使用 `memory task-start`, (中文(简体) ), `task-progress`, (中文(简体) ), `decision`,以及 `task-end` 直接关于真实的生命周期事件. `memory doctor` 区分 从实际检索/保存收据中连接访问;对返回的字节进行了测量 上下文,不是示范符号法案。 见 [生命周期合同](https://github.com/Ani-HQ/engram/blob/main/docs/AGENT-MEMORY.md) 用于设置,通用桥梁协议,私人状态,重试限制,以及警告.

## 自动化与环境

`ENGRAM_HOST` 是您的 engram 网关的基础 URL。 指导设置和医生 默认为 `https://engram.ani.computer` 当它被省略.

`ENGRAM_TOKEN` 这是为这把绳子签发的无记名标志.

当一个 MCP 客户端启动时, stdio 代理服务器使用两个变量 `engram-mcp` 与 没有子命令.

对于非交互式设置,请指定代理和供应 `ENGRAM_TOKEN` 绝对安全 通过您的进程环境,或用 `--token-stdin`数字 :

```bash
your-secret-reader | engram-mcp setup codex --project . --host https://engram.ani.computer --token-stdin
```

`your-secret-reader` 代表您的密码/ 机密管理器命令 。 设置 医生拒绝 `--token` 参数使资信不属历史。 失踪 在终端出口外输入可操作错误,而不等待 快点.

在终点站外, `--project` 选择完整的设置和 `--topic` 默认为 项目文件夹名称 . `--memory` 财务报告和审定财务报表 `upgrade` 需要明确 `--project` 在这里。 遗产非互动 `setup <agent>` 没有留下项目 只连接;其输出表示没有安装内存工作流程. `--connection-only` 选择明确的行为.

## 现有连接命令

```bash
engram-mcp connect <harness> --host https://engram.example.com --token tok_...
```

`--host` 财务报告和审定财务报表 `--token` 当 `ENGRAM_HOST` 财务报告和审定财务报表 `ENGRAM_TOKEN` 为: 设置。 缺少主机或令牌退出非零,不写入任何配置.

列出所支持的带和目标路径 :

```bash
engram-mcp connect --list
```

运行 `engram-mcp connect` 没有带子打印同样的列表.

现有 `connect` 命令仍然可用于脚本。 它写着配置 在试图发现之前, 仅靠它的成功并不能证明是活的. 偏爱 `setup` 用于引导, 核实登机。 每个文件首先复制 已有配置为 `<file>.engram-backup`;后期备份获得独特的后缀.

## 寒冷的开始

engram运行规模为零,所以闲置服务正在入睡,第一个请求支付 开始装箱 这比牵引装置可以让MCP服务器出现的时间更长, 并显示它是一个无法连接的服务器.

代理响应 `initialize` 本地有相同的内存和任务报告 指示为 HTTP 网关。 初始化不需要上游反应. 这些指令要求代理报告真实的工作; 连接不抓取 其他工具自动或回填旧任务.

`tools/list` 喜欢新的上游目录。 当缓存目录存在时, 它会等待 在使用缓存前,新结果最高750毫秒。 稍后的更改会发出 MCP 工具列表更改的通知, 这样支持客户端可以在同一位置刷新 届会。 没有缓存,发现需要上游反应,并仍然有限度 以 `ENGRAM_TIMEOUT_MS`。失败的发现会再次刷新 工具调用。 明确拒绝上游授权可删除证书 磁盘缓存并被返回,而不是将缓存工具作为当前访问. 如果已显示倒计时列表, 则更改通知会将其清除为空 标记目录 `authorization_required`; 修复访问后重新连接.

星表显示 `$XDG_CACHE_HOME/engram-mcp/tools-v2-<digest>.json` (或低于 `~/.cache`),由终点和证书一起键入. 熊熊的值永远不会 写入目录或文件名;文件在原子上被替换为模式 0600. 旧主机的缓存被忽略 . `connect` 种子服务时的新缓存 可达. 不尊重工具列表更改的客户端可能需要重新连接.

代理服务器还按键 `/health` 当它开始,所以容器 醒来的时候,你 仍在输入。 设定 `ENGRAM_TIMEOUT_MS` 更改按要求计算的上限 默认为90秒.

自动重试需要明确的一能操作. 工具调用,包括 任务报告,在不确定的响应或HTTP出错后不自动重试; 错误状态不能确定没有应用写入。 对于一个不确定的 `record_action` 在交货时,代理人可将相同的有效载荷与原有效载荷重试 `eventId` 因此,网关可以破解它.

## 支持的策略

`claude` 通过 Claude 代码 CLI 进行注册:

```bash
claude mcp add --scope user --transport http engram https://engram.example.com/mcp --header "Authorization: Bearer tok_..."
```

`connect claude` 需要克劳德代码CLI。 指导 `setup claude` 写入 本地 HTTP 条目为 `~/.claude.json` 直接和不需要通过一个符号 给一个孩子的命令.

`codex` 写入 `~/.codex/config.toml` 下级 `[mcp_servers.engram]`。 。 。 .

`cursor` 写入 `~/.cursor/mcp.json` 下级 `mcpServers.engram`。 。 。 .

`vscode` 写入用户 MCP 配置 :

-   马可斯: `~/Library/Application Support/Code/User/mcp.json`
-   林纳: `~/.config/Code/User/mcp.json`
-   窗口 : `%APPDATA%\Code\User\mcp.json`

VS 代码使用 `servers.engram` 与 `type = "http"` jSON中的语义学.

`windsurf` 写入 `~/.codeium/windsurf/mcp_config.json` 下级 `mcpServers.engram`。 。 。 .

## Stdio 代理服务器

对于 Stdio 客户端, 请配置已安装的 二进制 :

```json
{
  "mcpServers": {
    "engram": {
      "command": "engram-mcp",
      "env": {
        "ENGRAM_HOST": "https://engram.example.com",
        "ENGRAM_TOKEN": "tok_..."
      }
    }
  }
}
```

## 常见问题

### @ani-hq/engram-mcp 是什么？

一个命令 MCP 连接器和 estdio 代理软件

### 如何安装 @ani-hq/engram-mcp？

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

### @ani-hq/engram-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ani-hq\_\_engram-mcp 是否存在。

### @ani-hq/engram-mcp 需要什么版本的 Node\.js？

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

### @ani-hq/engram-mcp 可以商用吗？

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

### @ani-hq/engram-mcp 的下载量有多少？

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

### @ani-hq/engram-mcp 还在维护吗？

最新版本 0\.8\.0 发布于 2026/10/29（11 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/09/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。