# @everme/memory-mcp 中文文档

规范地址：https://npmcn.com/package/%40everme/memory-mcp/

版本：0\.7\.10
npm 元数据更新时间：2026-11-06T06:11:08.327Z
中文译文更新时间：2026-11-16T01:58:54.786Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40everme/memory-mcp
原文对照：https://npmcn.com/package/%40everme/memory-mcp/?lang=original
项目主页：https://everme.evermind.ai/
源码仓库：https://github.com/EverMind-AI/EverMe

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

- 包体积（解压后）：74.9 kB，8 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：2 个
- 首次发布：2026-05-12T05:37:02.712Z
- 最新版本发布：2026-11-06T06:11:08.139Z
- 近 30 天下载量：1963（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：28（近 12 个月 28 个）

## 中文简介

EverMe内存插件——任何MCP主机的通用MCP服务器(Cursor,Cline,通用JSON-RPC客户端). 具有本土插件格式(Claude Code,OpenClaw)的主机有自己的软件包.

## 安装

```sh
npm install @everme/memory-mcp
```

也可以使用：`pnpm add @everme/memory-mcp`、`yarn add @everme/memory-mcp`、`bun add @everme/memory-mcp`

## README

# @everme/memory-mcp (英语)

常规 **MCP 服务器** everMe记忆后端。 它支持本地stdio主机,托管无国籍的Streamable HTTP,以及认证的HTTP+SSE与Manus等云MCP客户端相容. 使用来自任何没有本地EverMe软件包的MCP语言主机——例如Cursor,Cline,或通用JSON-RPC客户端.

如果你在说:

-   **克劳德代码** • 使用 [`@everme/claude-code`](https://www.npmjs.com/package/@everme/claude-code) (本地插件:钩子+命令+技能+此 MCP 服务器)
-   **打开Claw** • 使用 [`@everme/openclaw`](https://www.npmjs.com/package/@everme/openclaw) (连接引擎插件)
-   **还有什么MCP** 使用此软件包

## 已曝光的工具

```
mem_context        durable user Profile snapshot only (no search, no episodes)
mem_search         hybrid memory search (text + vector), optionally bounded
                   to a conversation time window
mem_skill          full text of one agent skill, by the id printed in its
                   search-result line (served from the local skill cache)
```

每个工具的MCP `description` 携带自己的触发器, 所以主机 LLM 说吧 **自动** (会话开始时加载上下文,在 回引用, 保存一个声明的事实), 而用户无需询问 。 这个 服务器也通过 MCP 发布同样的协议 `instructions` 页:1 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}那个主机会浮出水面. `mem_search` 指导它保持 `query` 简称 ——几个关键词,不是整个对话粘贴在——并使用 默认 `topK` (10),所以请求保持小而搜索质量保持高.

`mem_search` 也选择 `startTime` 编号 : `endTime` (ISO 8601),其中第1行,第3行 编译到网关 `filters.timestamp` 作为 `gte` 编号 : `lte`任意绑定 可能孤立无援。 他们绑定了 **当谈话发生时**,而不是当 这件事发生了 描述让模型省略 除非用户给窗口取了名, 确定确切的日期—— 错误的绑定 返回零行,其读取完全像一个从未讨论过的主题. 在主机自己的时区完成无偏移的绑定,所以 模型用不着猜测用户在哪里。 应用窗口被响应 因此,一个错误计算的日期在同一反应中可见.

## 连接到主机的 mcpServers 配置

```json
{
  "mcpServers": {
    "everme-memory": {
      "command": "npx",
      "args": ["-y", "@everme/memory-mcp"],
      "env": {
        "EVERME_API_BASE": "https://api.everme.evermind.ai",
        "EVERME_AGENT_ID": "agt_...",
        "EVERME_AGENT_TOKEN": "evt_..."
      }
    }
  }
}
```

`evercli plugin install <host>` 为没有本地插件包的主机写入此内容 .

## 托管的 HTTP 模式

包裹也暴露了 `everme-memory-mcp-http`,用于 云剂不能产出局部分层过程. 所有 MCP 协议 端点需要 EverMe 代理符 :

```http
Authorization: Bearer evt_...
```

启动已安装的软件包 :

```bash
EVERME_API_BASE=https://api.everme.evermind.ai \
HOST=0.0.0.0 PORT=3000 \
everme-memory-mcp-http
```

或者在没有全局安装的情况下运行已发布可执行文件 :

```bash
EVERME_API_BASE=https://api.everme.evermind.ai \
npx -y -p @everme/memory-mcp everme-memory-mcp-http
```

主机模式需要节点.js 20或更晚. 在节点18,每 `POST /mcp` 请求 失败 `crypto is not defined`: MCP SDK可流式HTTP运输用途 全球Web Crypto对象,其Node.js 18不披露。 斯特迪奥服务器, `GET /sse` 财务报告和审定财务报表 `POST /messages` 关于Node.js 18号的工程(于18.20.8年测试, (原始内容存档于2026-10-30).

在生产负荷平衡器或倒置代理器上终止 TLS 。 不要通过一个 `emk_*` 账户密钥或这些端点的云映射提供者密钥 客户端证书是 `evt_*` EverMe代理代币. 主机模式不需要 `EVERME_AGENT_ID` 因为EverMe BFF从中获得了代理身份 符号 .

该服务揭露:

| 终点 | 运输 | 目的 |
| --- | --: | --- |
| `POST /mcp` | 可流取的 HTTP | 对现代MCP客户的无国籍请求 |
| `GET /sse` | HTTP+SSE 软件 | 为 Manus 打开一个经认证的相容会话 |
| `POST /messages?sessionId=...` | HTTP+SSE 软件 | 将 JSON- RPC 信件发送给已认证的SSE 会话 |
| `GET /health` | HTTP 密码 | 未经认证的负载平衡器健康检查 |

每个可流取的 HTTP 请求都会创建新的 MCP 服务器, 传输和 EverMe 客户端。 SSE 会话保留自己的 MCP 服务器直至断开并绑定 (一) SHA-256 打开它们的信使文摘; `/messages` 拒绝 a 不同的符号,即使呼叫者知道会话编号。 无证书 客户在请求、会议或租户之间共享。 MCP层继续 只给EverMe打电话 `/api/v1/mem/*` BFF; 云梦V1/V2 路由停留 在BFF的背后,并且对客户来说是隐形的.

| 变量 | 默认 | 目的 |
| --- | --: | --- |
| `EVERME_API_BASE` | `https://api.everme.evermind.ai` | EverMe BFF 来源 |
| `HOST` | `0.0.0.0` | 听众地址 |
| `PORT` | `3000` | 听声音端口 |
| `MCP_HTTP_MAX_BODY_BYTES` | `1048576` | 最大 JSON 请求体(1 MiB) |
| `MCP_HTTP_RATE_LIMIT` | `60` | 每个窗口允许的每个符号摘要请求 |
| `MCP_HTTP_RATE_WINDOW_MS` | `60000` | 固定利率限制窗口(以毫秒计) |
| `MCP_HTTP_TOKEN_VALIDATION_MAX_PENDING` | `100` | 对不同新标志的最大并行验证 |

在新摘要进入限制器之前,主机模式通过验证符号 稳定的 BFF `/mem/capabilities` 路径; 失败的证书不消耗限制 能力。 当前窗口的成功验证被缓存, 最多 1万个经验证的代币文摘被跟踪到记忆中. 重复验证 一种标志是连在一起的,同时验证不同的新标志 默认上限为100。 横向部署也应 在入侵时执行每个IP和全球共享限制.

对于Manus,从EverMe连接页面生成远程代理证书, 打开 Manus MCP JSON 导入器,粘贴生成的配置 :

```json
{
  "mcpServers": {
    "everme": {
      "transport": "sse",
      "url": "https://api.everme.evermind.ai/sse",
      "headers": {
        "Authorization": "Bearer evt_..."
      }
    }
  }
}
```

信使还了一次. 重生成 Manus 配置旋转 符号和无效前一个配置.

## 建筑

顶端的瘦适配器 [`@everme/agent-sdk`](https://www.npmjs.com/package/@everme/agent-sdk)。此软件包拥有 MCP 框架(stdio,无国籍的可流式HTTP,或HTTP+SSE),工具列表和发送。 其他一切——EverMe BFF客户端,实时代理-记忆书写,搜索/文本呼叫,再试,和编辑——都来自SDK.

## 测试

```
npm test
```

## 许可证

阿帕奇 - 2.0

## 常见问题

### @everme/memory-mcp 是什么？

EverMe内存插件——任何MCP主机的通用MCP服务器\(Cursor,Cline,通用JSON-RPC客户端\)\. 具有本土插件格式\(Claude Code,OpenClaw\)的主机有自己的软件包\.

### 如何安装 @everme/memory-mcp？

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

### @everme/memory-mcp 支持 TypeScript 吗？

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

### @everme/memory-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @everme/memory-mcp 需要什么版本的 Node\.js？

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

### @everme/memory-mcp 可以商用吗？

@everme/memory-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @everme/memory-mcp 的下载量有多少？

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

### @everme/memory-mcp 还在维护吗？

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

