@ani-hq/engram-mcp

中文文档
0.8.0发布于 2026/10/29MIT近 30 天下载 1769

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

中文使用文档
文档目录9 节
  1. 连接此计算机
  2. 代理设置
  3. 检查连接
  4. 切入内存生命周期
  5. 自动化与环境
  6. 现有连接命令
  7. 寒冷的开始
  8. 支持的策略
  9. Stdio 代理服务器

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

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

连接此计算机

在您的终端运行 :

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

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

为每个代理撰写的确切文件列于 文件/出版物。 。 。 .

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

代理设置

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

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 和私人技能控制,而不是本地文件系统路径.

检查连接

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分钟后支票就过期了,从不 证明自动使用模型。 见 内存生命周期。 。 。 .

切入内存生命周期

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

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指导:

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优先 。 见 代理兼容性 用于已执行的表面、固定检查和剩余的实际应用验证.

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

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 区分 从实际检索/保存收据中连接访问;对返回的字节进行了测量 上下文,不是示范符号法案。 见 生命周期合同 用于设置,通用桥梁协议,私人状态,重试限制,以及警告.

自动化与环境

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

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

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

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

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 选择明确的行为.

现有连接命令

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

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

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

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 进行注册:

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 客户端, 请配置已安装的 二进制 :

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

版本与发布记录

@ani-hq/engram-mcp 共发布 11 个版本,首次发布于 2026/09/08;过去 12 个月发布了 11 个版本。

版本发布日期距今
0.8.0latest2026/10/2911 天前
0.7.22026/10/2812 天前
0.7.12026/10/2812 天前
0.7.02026/10/2812 天前
0.6.02026/10/2812 天前
0.5.22026/10/2614 天前

关于 @ani-hq/engram-mcp 的常见问题

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