MCP 工具参考

一个启动命令。
清晰的记忆工具。

运行一次 setup 并重启你的 AI 工具。之后 Engram 会以 MCP 工具和启动指南出现;需要时再查看下面的专用工具。

先通过 npm 免费试用

npm 客户端不需要邮箱或 API 密钥。在获准修改 AI 工具配置后,运行 setup,重启客户端,然后描述实际仓库和任务。添加 --dry-run 可先预览变更。请保留已有的 Engram 工作区连接。

npx -y engram-tools@latest --setup

调用 engram_start,用 engram_store 保存一条已确认的项目决策,再在新会话中检索它。

首次记忆调用会开启 7 天试用:25 条私有记忆,每天 20 次调用,累计 100 次。

如需保留同一工作区,之后运行 npx -y engram-tools@latest connect 并验证邮箱。

远程 OAuth 连接,例如工具市场中的连接,需要在连接时验证邮箱。

也可以创建通过邮箱验证归属的工作区

步骤 1

输入邮箱

免费开始:100 条工作区私有记忆、1 位开发者,以及 100,000 条公共记忆。无需信用卡。

步骤 2

验证 OTP 验证码

我们先发送 6 位验证码,避免别人用他人的邮箱创建账号。

步骤 3

接收你的 API key

验证后,Engram 会自动创建你的 workspace,并通过邮件发送 setup key。

在哪里获取 API 密钥?

创建免费工作区并验证邮箱。Engram 会在欢迎邮件中发送你的专属 API 密钥和可直接运行的安装命令。如果已经注册,请再次使用同一邮箱获取当前密钥。

免费获取 API 密钥
步骤 4

启动你的 agent

使用 API 密钥运行 npx engram-tools@latest --setup,重启 AI 工具,然后像平常一样说明项目和任务。Engram 会通过 MCP 自动引导智能体。

npx -y engram-tools@latest --setup

检查连接和第一条有用的记忆

向代理说明项目和任务。完成实际工作后,让它保存一项长期有效的决定,再在新会话中恢复。仅安装不会创建项目私有记忆。

npx -y engram-tools@latest --doctor
  • 看不到工具?完全退出并重新打开客户端,检查 Node.js 20+ 和 npx。通常无需重装。
  • 每个客户端都有独立配置。运行下方检查,再使用正确工作区的密钥执行 --setup --client codex。--update 保留现有绑定。
  • Gemini 可能要求文件夹信任和 MCP 授权。通过控制台邀请同事,让每个人获得同一共享工作区的独立密钥。

客户端专用配置

setup 命令会自动处理。下面展示不使用默认 JSON 格式的客户端实际需要的配置形状。

Antigravity

Google 当前的 Gemini 流程可能会把用户引导到 Antigravity。Engram 会同时写入共享 Gemini 配置和 Antigravity 专用配置文件。

// ~/.gemini/config/mcp_config.json
// ~/.gemini/antigravity/mcp_config.json
{
"mcpServers": {
"engram": {
"command": "npx",
"args": ["-y", "engram-tools@latest", "mcp"]
}
}
}

OpenCode

OpenCode 使用命令数组,而不是标准 mcpServers 结构。setup 会自动写入这种格式。

// ~/.config/opencode/opencode.json
{
"mcp": {
"engram": {
"type": "local",
"command": ["npx", "-y", "engram-tools@latest", "mcp"],
"enabled": true
}
}
}

Codex

Codex 使用 TOML。Engram 只替换 engram 表,并保留其他 Codex 配置。

# ~/.codex/config.toml
[mcp_servers.engram]
type = "stdio"
command = "npx"
args = ["-y", "engram-tools@latest", "mcp"]
可选的首次会话提示词

Engram 也会通过 MCP 指导 agent。这个提示让第一次会话更明确,帮助 agent 在正确时机使用 recall、cross-pollination 和 rehydrate。

欢迎邮件里也有这段。文档中保留它,是为了在 AI 客户端忽略 MCP 启动指引时可以快速复制。

用这个上下文调用 engram_start:
project: <产品或客户>
repo: <repo>
role: <角色>
market: <领域或市场>
stack: <主要技术>
task: <当前任务>
选择方案前调用 engram_recall。
如果其他 repo 可能解决过这个模式,调用 engram_cross_pollinate。
如果聊天被压缩或恢复,继续前调用 engram_rehydrate。

记忆、时效与反馈

本指南说明工具的实际行为。参数表直接来自 MCP schema。响应示例是已去除敏感信息的 HTTP 片段。MCP 通过 text/format 返回 JSON、Markdown 或简短确认;解析前请检查 format。

根据目的选择工具

开始仓库工作

engram_start

工作区说明和相关记忆

回答一个具体问题

engram_recall

针对该问题排序的记忆

上下文仍在,但需要切换任务

engram_smarter

新任务的背景摘要

上下文丢失后继续工作

engram_rehydrate

安全恢复会话日志,必要时利用当前记忆

记录阶段性进展

engram_reflect

保存检查点;会话保持开启

npm 客户端可以在没有邮箱或 API 密钥的情况下创建独立的免费试用。远程 OAuth 连接需要邮箱验证。切勿编造凭据。repo 是已授权工作区内的记忆过滤条件,不会授予另一个工作区的访问权限。

开始仓库工作用 engram_start,查询具体问题用 engram_recall,切换任务用 engram_smarter,上下文压缩或工作中断后用 engram_rehydrate。Smarter 为新任务检索长期记忆,不会重建旧日志。两者都可能记录会话事件。Rehydrate 可以读取已关闭或同事的历史,但不能重新打开或写入这些会话。engram_reflect 保持会话开启;engram_close_session 才是明确结束会话的操作。

focused 默认返回 start=8、recall=5、smarter=5、cross_pollinate=5 条记忆。deep 默认分别为 16、12、12、12。显式 limit 会在工具允许的上限内覆盖默认数量。除非显式指定 include_skills=true 或 false,否则系统会按任务关键词选择相关操作指南。

Rehydrate 使用独立的日志详细度:depth=brief 最多 12 个事件和 2 份摘要,standard 为 30 和 4,full 为 60 和 8。不接受 limit,也不接受检索深度 focused/deep。

如果 recall 返回 count=0,应说明没有找到匹配记忆。检查 repo 和查询,必要时改写问题或使用 depth=deep。增加结果数量不会让无关信息变得相关。只有在其他仓库可能有可迁移经验时才使用 cross_pollinate。get_context 用于主动按类别检查记忆,并非每次空结果后的自动下一步。

将规则与会变化的事实分开

每条记忆最好只包含一个可独立维护的事实。权限规则与部署状态应有不同 ID。单条内容使用 type、content 和可选 claim;多条内容使用 claims,包含 1–32 个独立单元,每个都有 type、content、claim。不要混用两种格式。旧的未分类记忆仍为 legacy_unassessed;添加元数据不代表一条笔记一定只含一个事实。

type 是 CONVENTION、SOLUTION 等检索类别;claim.kind 区分 rule、decision、state、lesson、reference。仅 state 有 stage,可取 proposed、implemented、tested、deployed。State 必须提供带时区的 ISO 时间 observed_at,不能比服务器时间超前超过一分钟。可使用 UTC 或明确的时区偏移,请同步客户端时钟。tested/deployed 还需 evidence。证据由代理提供,Engram 不会独立核实。可选 review_after 不得早于 observed_at;它表示复查时间,不会自动使记忆过期,也不是撤销规则的授权。

kind=rule 标签不会赋予代理人的权限,也不能覆盖当前指令。只有验证过替换关系后,才使用 supersedes_memory_ids 和 change_reason。拆分旧笔记时,split_from 包含 memory_id 和 content_sha256,默认只预览。只有提供 dry_run=false 和实际返回的 split:<id>:<plan_hash> 确认值后才应用。历史部分仍然是历史,不要把旧笔记的成功票继承给无关的新事实。

示例:将占位符替换为实际返回的值。

{
  "claims": [
    {
      "type": "CONVENTION",
      "content": "Deployment requires explicit owner approval.",
      "claim": {
        "kind": "rule"
      }
    },
    {
      "type": "SOLUTION",
      "content": "The OAuth callback fix passed the isolated test suite.",
      "claim": {
        "kind": "state",
        "stage": "tested",
        "observed_at": "2026-11-15T09:00:00Z",
        "evidence": "Commit abc1234; isolated OAuth regression receipt"
      }
    }
  ]
}
审查混合旧笔记,同时保留有效规则

如果笔记同时包含有效审批规则和过时发布状态,不要为了隐藏状态而撤回整条笔记。先逐一核查独立事实。在拟定 claims 中保留有效规则,仅将过时部分标为历史。只有创建者或工作区的人类所有者能拆分;源记录必须私有、有效,且尚未声明为独立 claim。

预览时同时发送 claims 和 split_from。content_sha256 必须基于保存的原文计算,不能使用缩略显示或改写文本。预览不会写入记忆。应用前检查返回的 claims、active_claims、historical_claims。下例是 MCP SDK 伪代码:source 表示真实源记忆,claims 是审查后的单元列表,只有过时部分使用 historical:true。

再次提交未改变的源记录和计划,并设置 dry_run=false,原样使用预览返回的 confirmation。不要自行构造确认值。源记录或计划改变后,需要重新预览。原笔记作为历史保留,新单元有各自 ID,且不继承旧票数。预览只校验写入方案的结构,不证明你的事实判断正确。

示例:将占位符替换为实际返回的值。

const plan = {
  split_from: {
    memory_id: source.id,
    content_sha256: sha256(source.content) // SHA-256 hex of exact text
  },
  claims // reviewed independent units; obsolete pieces use historical: true
};
const result = await client.callTool({ name: "engram_store", arguments: plan });
if (result.isError) throw new Error("Split preview failed");
if (result.structuredContent?.format !== "json") throw new Error("Expected JSON preview");
const preview = JSON.parse(result.structuredContent.text);
// Review preview.claims, active_claims and historical_claims before applying.
await client.callTool({
  name: "engram_store",
  arguments: { ...plan, dry_run: false, confirmation: preview.confirmation }
});
有用不等于已核实或仍然有效

success=true 表示记忆帮助完成了任务,并不证明它现在属实、已在生产环境运行,或旧混合笔记中的每句话都正确。trust=validated 和 confidence 是对已报告有用性的兼容性标签,不是独立验证。请查看 claim.stage、observed_at、evidence、last_outdated_report_at,并用当前代码和运行证据核查关键事实。

初始相关性可为 relevant、irrelevant、uncertain。实际使用效果可为 helpful、unhelpful、not_used、not_evaluated。只有 helpful/unhelpful 会产生结果票并影响 confidence。结果可以同时是 irrelevant 和 not_used,而不产生使用失败票。没有反馈就保持未评价状态。相关性说明与实际使用证据分别保存。

通过 engram_reflect.feedback 或 POST /api/v1/feedback 提交 useful/noisy/stale/missing_context/too_long,是在评价 Engram 产品本身。它与单条记忆的使用结果独立,不会修改该记忆的 confidence。

准确关联查询,并安全处理重试

retrieval_id 标识已记录的一次结果列表展示,session_id 标识会话日志。将每个 retrieval_id 与对应列表一同保留,尤其是同一记忆出现在多个并行查询时。retrieval_id 为 null 表示该响应无法精确归因。只要回执、记忆和调用者仍满足访问条件,旧查询或已关闭会话也可接收显式反馈;不要重开源日志。

单次实际使用通过 engram_report_outcome 传入 memory_id、success、retrieval_id。批量使用 outcomes,最多 20 个唯一的查询/记忆组合。也可将相同条目作为 pending_feedback 附在下一次 start、recall、smarter、store、reflect、cross_pollinate、get_context、skill、report_outcome 调用中。需要 outcome:write,但不额外消耗调用配额。无法评价的条目应省略,不能编造结论。

重试精确反馈时,发送相同的 retrieval_id、memory_id 和实际使用字段。Engram 会在响应中返回 duplicate=true,不增加票数。duplicate 不是输入,也不存在 retry 开关。相同重试不报 409;只有修改已记录的使用票才返回 409。旧格式缺少 retrieval_id 时,会选取过去 24 小时内同一认证成员和工作区中,包含该记忆的最新展示。session_id 可把范围限制到指定日志。旧格式重试可能增加票数,这种推断不能当成精确关联。真正的新使用应有新的检索展示。

反馈批次先于主操作提交。即使主操作失败,也应查看 feedback_receipt,因为反馈可能已成功保存。远程 MCP 和 npm 客户端都会在错误中保留回执。已提交反馈后的错误不会自动重试,但主操作本身仍可能不具幂等性。reflect.used_memories 中,最多 20 个精确反馈条目必须各带 retrieval_id,作为一个原子批次提交;旧格式放到另一次 reflect 中。后续学习或检查点可能失败,feedback_receipt 会说明已接受的结果。

示例:将占位符替换为实际返回的值。

{
  "repo": "example",
  "query": "Which deployment rule applies?",
  "pending_feedback": [
    {
      "retrieval_id": "<id from the previous result list>",
      "memory_id": "<memory in that list>",
      "relevance": "irrelevant",
      "usefulness": "not_used"
    }
  ]
}

推荐:精确关联检索的使用结果(engram_reflect 参数)

{
  "store": false,
  "summary": "Applied the recalled approval rule.",
  "used_memories": [
    {
      "retrieval_id": "<id from that result list>",
      "memory_id": "<memory in that list>",
      "success": true,
      "detail": "Checked owner approval before releasing."
    }
  ]
}

仅用于兼容:单独提交旧格式反馈(engram_reflect 参数)

{
  "store": false,
  "summary": "Reported a use without a retained query receipt.",
  "used_memories": [
    {
      "memory_id": "<accessible memory id>",
      "success": true,
      "detail": "This use has inferred attribution, not an exact query link."
    }
  ]
}
撤回、永久删除与安全恢复

engram_retract_memory 可逆地撤回私有知识,创建者或人类工作区所有者可以操作。engram_restore_memory 要求撤回记录仍被保留,并检查配额和已确认的替换关系。再次保存相同文本或调用 rehydrate 都不会静默恢复它。已永久删除的记录无法恢复。

OAuth token 即使属于 OWNER 成员,也不能预览或执行永久删除。两种操作都需要单独使用人类工作区所有者的 API 凭据。不要获取或替换为所有者密钥来绕过 OAuth 限制。engram_delete_memory 默认预览影响;执行必须设置 dry_run=false 和 confirmation=delete:<exact memory_id>。它会删除在线记忆、已知关联副本及受影响日志的自由文本。已传给客户端的上下文、独立记录、无关联改写、服务商和备份不在此次定向删除范围内。

会话列表会隐藏与已撤回、过期或已删除知识关联的任务文本。如果无法安全重建日志,请使用安全的当前记忆,或用 engram_start(new_session=true) 创建干净日志,不要绕过隐藏机制。恢复仍保留的源记录,可能重新开放其安全保留的历史。

工具

选择一个工具查看

核心闭环

正常编码流程工具,以及压缩后的恢复。

高级工具与检查点

保留可用,但只有触发条件真实时才使用。

选择一个工具查看
engram_start

用于有实质工作的会话开头;恢复丢失上下文请用 rehydrate。

engram_start

开始仓库工作。

用于有实质工作的会话开头;恢复丢失上下文请用 rehydrate。

session_id
可选
string

start/rehydrate/list_sessions 返回的准确日志 ID,用于区分并行工作。写入必须使用自己的有效会话;rehydrate 可读共享或关闭历史。

agent_tool
可选
string

调用客户端名称,如 codex、claude-code、cursor、gemini;未知时省略。

project
推荐
string

产品或项目名称。缺少 repo 时,start/setup 用它作为仓库提示。

repo
推荐
string

授权工作区内的仓库标识。它是记忆过滤器,不是文件路径或工作区选择器。

role
可选
string

代理职责,如后端工程师;start/setup 默认为实施代理。

market
可选
string

业务领域背景,不是地理访问控制。

task
推荐
string

当前具体目标或决策,用于聚焦上下文和恢复。

stack
可选
string[]

项目技术栈,未知时省略。

context
可选
string

可选完整任务背景;覆盖由 project、role、market、stack、task 生成的查询。

new_session
可选
boolean

默认 false 复用合适的有效日志。true 为并行工作创建新日志,重试可能创建更多会话;保留 session_id。

include_skills
可选
boolean

是否包含相关操作指南。未提供时按关键词推断;false 排除指南。

limit
可选
number

最多 1–30 条记忆。默认 focused=8、deep=16;显式 limit 覆盖默认值。

depth
可选
focused | deep

默认 focused 使用较小检索预算;不足时 deep 扩大。显式 limit 覆盖默认预算。

pending_feedback
可选
object[]

针对之前 retrieval_ids 的批次,先于本操作单独提交。需 outcome:write;相同实际使用可安全重试。不额外消耗调用配额,省略未评价结果。

继续阅读

什么是MCP?

使Engram成为可能的标准。

📡

Anthropic的开放标准

MCP(模型上下文协议)是Anthropic创建的开放标准。它让AI Agent通过简单、通用的接口连接外部工具和数据源。

🔌

AI的USB

把它想象成AI的USB:一个标准,所有工具都能用。没有自定义集成,没有专有SDK,没有供应商锁定。如果你的工具支持MCP,它就能直接使用。

🧠

Engram是MCP服务器

任何兼容MCP的AI工具都可以连接Engram。Claude Code、Cursor、Gemini、Antigravity、Copilot、OpenCode、Windsurf、Devin。。只要支持MCP,就支持Engram。

⚡

零集成工作

无需SDK。无需自定义集成代码。只需将Engram添加到代理的MCP配置中,即可立即获得8个新的记忆工具。

连接方式

你的Agent

Claude、Cursor 等

MCP
➞

Engram

MCP 服务器

存储/召回
➞

团队记忆

PostgreSQL + pgvector

Workspace 是团队的 记忆边界

一个团队使用一个 workspace。repo 和项目名在其中组织项目记忆。请从 dashboard 邀请队友,让每个人都有自己的 key。

前端 repo

工具

Claude CodeCursorCopilot
记忆45

API repo

工具

Claude CodeWindsurf
记忆128

移动端 repo

工具

CursorDevin
记忆67

Workspace 的含义

  • ✓Workspace 是团队或公司的私有记忆边界。
  • ✓repo 和项目名在这个边界内组织记忆。
  • ✓请从 dashboard 邀请队友,让每个人使用独立 key。
  • ✓同一 workspace 的 agent 可以跨 repo 复用私有经验。
  • ✓不同 workspace 相互隔离;公共记忆仍可补充结果。
workspace-sync.sh
$ engram_get_context({ repo: "api-backend" })

领先起步,而非从零开始

每个新工作区都会从 100,000 条带来源的公共记忆开始,覆盖 Agent 工具、MCP、RAG/搜索、安全、运维、工程文档和产品/devex。

100K
公共记忆
7
来源类别
20
技能指南
🔄
330+
模式
验证过的方法
模式

常见任务的验证方法。示例:"API路由模式:try-catch包装器、验证输入、检查认证、然后业务逻辑。"模式告诉你如何正确地做事。

📏
170+
约定
团队规则和标准
约定

团队规则和编码标准。示例:"始终使用Prisma迁移,永远不要直接用SQL ALTER TABLE。"规范保持代码库的一致性。

⚠️
155+
陷阱
陷阱和意外
陷阱

会出错或让你意外的事。示例:"forEach中的async/await不会按预期工作。请改用for...of。"陷阱为你节省数小时的调试时间。

🔧
215+
解决方案
经过验证的修复
解决方案

常见问题的实战验证修复。示例:"Next.js水合不匹配:使用useEffect处理仅客户端逻辑。"解决方案给你答案,而不仅仅是提示。

📦
100+
依赖
框架特定
依赖

框架版本特定知识。示例:"Prisma 7需要PrismaPg适配器模式。"依赖知识防止升级意外。

🎓
20
技能指南
分步指南
技能指南

复杂任务的分步指南。示例:"代码审查技能:从拉取分支到批准的15个步骤。"技能按需给你的Agent专业知识。

来源: 覆盖范围:React、Next.js、Vue、Angular、Python、Go、Rust、TypeScript、PostgreSQL、Docker、Kubernetes、AWS及25+其他技术。商业技能:产品管理、销售、营销、人力资源、法务、财务等。

其他 Agent 从空白开始。你的 Agent 从 100,000 条带来源的公共记忆、20 个分步指南和第一天就开始增长的团队私有记忆开始。

两个记忆库。一个更聪明的 agent。

公共知识面向所有人。私有知识只属于你的团队。

🌍
100K

公共记忆库

  • ✓100,000 条带来源的公共记忆
  • ✓Agent 工具、MCP、RAG/搜索、安全、运维和 devex
  • ✓20 个分步指南
  • ✓最佳实践模式、常见坑、解决方案和证据检查
  • ✓随着公共库增长而更新
  • ✓Disponible para todos los usuarios de Engram
Gratis en todos los planes
🔒
隔离

私有记忆库

  • ✓你团队自己的专有知识
  • ✓代码库专属约定
  • ✓Decisiones internas de arquitectura
  • ✓Aprendizajes de incidentes y post-mortems
  • ✓绝不会在你的 workspace 外共享
  • ✓隔离、加密,并限定在 workspace 内
Tu ventaja competitiva
El agente hace recall
↓
Busca primero en privado
↓
Enriquece con público
↓
Mejores resultados combinados
组合召回

先查私有记忆。公共知识补齐空白。

Engram 先搜索你的工作区知识;有帮助时,再加入带来源的公共实践和指南。

engram_start

支持和反馈

帮助我们改进 Engram

如果 setup 让人困惑、工具行为异常或价格限制看起来不对,请在这里告诉我们。消息会直接到我们这里。

支持和反馈

我们该改进什么?

Bug、混乱的 setup 步骤、价格问题和产品想法都会直接发送给 Engram 团队。

请先验证邮箱,再将反馈发送给我们的团队。此操作不会创建账户。

还需要 10 个字符0/4000