MemoraEU

memoraeu-mcp

🇬🇧 English | 🇫🇷 Français

---

英语

Claude 的零知识持久化记忆层 — MCP 服务

MemoraEU 为 Claude 提供持久化的加密记忆。所有内容都会在抵达服务端之前，先在客户端使用 AES-256-GCM 加密——服务端永远无法看到明文。语义搜索由 Mistral 嵌入向量提供支持，这些向量会在加密前在你的设备上本地生成。

功能

• 🔒 零知识 — 使用 AES-256-GCM 加密，密钥永远不会离开你的设备
• 🧠 语义搜索 — 嵌入向量在加密前本地生成（服务端使用 Qdrant）
• 🔄 自动记忆 — 自动记忆并回忆上下文
• 🚫 去重 — 存储前检测近似重复的记忆
• 🇪🇺 欧盟托管 — 符合 GDPR 的基础设施

安装

pip install memoraeu-mcp

也可以使用 uvx（无需安装，推荐）：

uvx memoraeu-mcp

Claude Desktop 配置

在 claude_desktop_config.json 的 mcpServers 下添加：

{
  "mcpServers": {
    "memoraeu": {
      "command": "uvx",
      "args": ["memoraeu-mcp"],
      "env": {
        "MEMORAEU_API_URL": "https://api.memoraeu.com",
        "MEMORAEU_API_KEY": "meu-sk-...",
        "MEMORAEU_SECRET": "your-memoraeu-password",
        "MEMORAEU_SALT": "your-kdf-salt",
        "MISTRAL_API_KEY": "your-mistral-key"
      }
    }
  }
}

了解这些变量

这五个变量分别用于三个不同的目的——它们不可互换：

变量	用途	获取方式
MEMORAEU_API_KEY	HTTP 身份验证（随每个请求发送的 Bearer 令牌）	Dashboard → Settings → API Keys
MEMORAEU_SECRET	你的 MemoraEU 登录密码——用作 PBKDF2 的输入，在本地派生加密密钥	你的账户密码
MEMORAEU_SALT	服务端生成的 KDF 盐值，每个账户唯一——与 MEMORAEU_SECRET 组合后生成加密密钥	Dashboard → Settings → Encryption Keys
MEMORAEU_API_URL	API 端点（托管服务请使用 https://api.memoraeu.com）	—
MISTRAL_API_KEY	用于在加密前本地生成嵌入向量——零知识搜索所必需（见下文）	console.mistral.ai

为什么 MCP 需要自己的 Mistral 密钥？

零知识意味着服务端永远看不到你的明文。要启用语义搜索，必须在内容加密前，在你的设备上计算嵌入向量。MCP 会使用明文直接调用 Mistral，获取嵌入向量，然后加密内容，再将两者发送到服务端。服务端会存储无法识别的加密数据和向量，但无法还原原始文本。没有 MISTRAL_API_KEY，语义搜索将无法使用。

没有 MISTRAL_API_KEY 时： MCP 仍然可以运行——remember 和 recall 均可正常工作，但语义搜索会退回到服务端的关键词搜索。零知识加密不受影响。

获取密钥

1. 在 app.memoraeu.com 注册
2. 前往 Settings → Encryption Keys → 复制 MEMORAEU_SALT
3. MEMORAEU_SECRET 是你的 MemoraEU 登录密码
4. 前往 Settings → API Keys → 创建密钥 → 复制 MEMORAEU_API_KEY
5. 在 console.mistral.ai 获取 Mistral API 密钥

通过 SSE 使用远程 MCP（无需本地安装）

你可以直接从 claude.ai 网页版、Cursor、Windsurf 或任何远程 MCP 客户端连接，无需在本地安装任何内容：

SSE endpoint: https://api.memoraeu.com/mcp/sse
Auth: Authorization: Bearer meu-sk-...

Cursor / Windsurf 配置示例：

{
  "mcpServers": {
    "memoraeu": {
      "type": "sse",
      "url": "https://api.memoraeu.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer meu-sk-..."
      }
    }
  }
}

注意： 在 SSE 远程模式下，内容不会进行零知识加密（服务端会处理明文）。如需完整的零知识保障，请使用本地 stdio 安装方式。

可用工具

工具	说明
remember	自动记忆重要信息
recall	对已存储的记忆进行语义搜索
forget	按 ID 删除记忆
list_memories	列出近期记忆，可选按类别筛选
list_categories	按使用频率排序并返回现有类别
remember_fact	存储带有时间有效性的结构化事实（主体/谓词/客体）
recall_facts	获取某个主体的有效事实
invalidate_fact	按 ID 将事实标记为已过期

自动记忆行为

此 MCP 服务旨在无需手动干预即可运行：

自动回忆 — 每个会话中收到第一条用户消息时，会自动调用 recall，并将检测到的主题作为查询。最近的记忆也会通过 memoraeu://context 资源加载，并注入会话上下文。

自动记忆 — 当 Claude 检测到值得记住的信息（偏好、决定、个人背景事实、技术限制）时，会自主调用 remember，无需等待用户提出要求。它会用一行简短低调的消息进行确认。

系统提示词注入 — 首次调用 recall 时，完整的行为系统提示词会注入 Claude 的上下文，以便在会话剩余时间内强化自动记忆规则。

此行为直接编码在工具描述中。Claude 模型会在使用工具时遵循这些指令，无需额外配置。

去重与压缩

存储记忆前，MCP 会使用向量相似度检测近似重复内容：

相似度	操作
≥ 94%	跳过记忆 — 检测到完全重复内容
85–94%	记录警告，但仍存储记忆
< 85%	正常存储记忆

Mistral 会在加密前压缩较长的记忆（> 300 个字符），以减少 Token 用量并提高搜索相关性。压缩在明文状态下进行，先于内容加密 — 服务端也永远不会看到未压缩的原文。

自托管

API 为开源。使用 Docker 部署自己的实例：

git clone https://github.com/pquattro/memoraEu
cd memoraEu
docker compose up -d

---

法语

Claude 的零知识持久记忆层 — MCP 服务

MemoraEU 为 Claude 提供持久且加密的记忆。所有内容都会在到达服务端之前，先在客户端使用 AES-256-GCM 加密 — 服务端永远不会看到明文。语义搜索依赖于加密前在本地生成的 Mistral 嵌入。

功能

• 🔒 零知识 — AES-256-GCM 加密，密钥永远不会离开您的设备
• 🧠 语义搜索 — 加密前在本地生成嵌入（服务端使用 Qdrant）
• 🔄 自动记忆 — 无需干预即可记住并回忆上下文
• 🚫 去重 — 存储前检测重复内容
• 🇪🇺 托管于欧洲 — 符合 GDPR 的基础设施

安装

pip install memoraeu-mcp

或者使用 uvx（无需安装，推荐）：

uvx memoraeu-mcp

Claude Desktop 配置

在您的 claude_desktop_config.json 的 mcpServers 部分中添加：

{
  "mcpServers": {
    "memoraeu": {
      "command": "uvx",
      "args": ["memoraeu-mcp"],
      "env": {
        "MEMORAEU_API_URL": "https://api.memoraeu.com",
        "MEMORAEU_API_KEY": "meu-sk-...",
        "MEMORAEU_SECRET": "votre-mot-de-passe-memoraeu",
        "MEMORAEU_SALT": "votre-kdf-salt",
        "MISTRAL_API_KEY": "votre-clé-mistral"
      }
    }
  }
}

各变量的作用

这五个变量各有三种不同的作用——不可互换：

变量	作用	获取位置
MEMORAEU_API_KEY	HTTP 身份验证（每次请求都会发送 Bearer token）	Dashboard → Paramètres → Clés API
MEMORAEU_SECRET	您的 MemoraEU 密码——用作 PBKDF2 的输入，以便在本地派生加密密钥	您的登录密码
MEMORAEU_SALT	由服务器生成、对您的账户唯一的 KDF salt——与 MEMORAEU_SECRET 组合以生成加密密钥	Dashboard → Paramètres → Clés de chiffrement
MEMORAEU_API_URL	API 端点（托管服务请使用 https://api.memoraeu.com）	—
MISTRAL_API_KEY	加密前在本地生成嵌入——零知识搜索所必需（见下文）	console.mistral.ai

为什么 MCP 需要 Mistral 密钥？

零知识意味着服务器永远不会看到您的明文。为了支持语义搜索，必须在加密之前、在您的设备上计算嵌入。MCP 会直接将明文发送给 Mistral，获取嵌入向量，然后加密内容，并将两者发送到服务器。服务器会存储不透明的数据块和向量，但无法还原原始文本。没有 MISTRAL_API_KEY，语义搜索将无法使用。

没有 MISTRAL_API_KEY： MCP 仍可正常运行——remember 和 recall 仍可使用，但语义搜索会切换为服务器端关键词搜索。零知识加密不受影响。

获取密钥

1. 在 app.memoraeu.com 创建账户
2. 前往 Paramètres → Clés de chiffrement → 复制 MEMORAEU_SALT
3. MEMORAEU_SECRET 是您的 MemoraEU 登录密码
4. 前往 Paramètres → Clés API → 创建密钥 → 复制 MEMORAEU_API_KEY
5. 在 console.mistral.ai 获取 Mistral 密钥

通过 SSE 使用远程 MCP（无需本地安装）

直接从 claude.ai 网页版、Cursor、Windsurf 或任何远程 MCP 客户端连接，无需安装任何内容：

Endpoint SSE : https://api.memoraeu.com/mcp/sse
Auth : Authorization: Bearer meu-sk-...

Cursor / Windsurf 配置示例：

{
  "mcpServers": {
    "memoraeu": {
      "type": "sse",
      "url": "https://api.memoraeu.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer meu-sk-..."
      }
    }
  }
}

注意： 使用远程 SSE 模式时，内容不采用零知识加密（服务器会处理明文）。如需完整的零知识保障，请使用本地 stdio 安装方式。

可用工具

工具	说明
remember	自动记住重要信息
recall	在已存储的记忆中进行语义搜索
forget	根据 ID 删除一条记忆
list_memories	列出最近的记忆，可选添加筛选条件
list_categories	按使用频率排序并返回现有类别
remember_fact	存储结构化事实（主体/谓词/客体），并设置有效期
recall_facts	获取某个主体的有效事实
invalidate_fact	根据 ID 将一条事实标记为已过期

自动记忆行为

MCP 服务旨在无需人工干预即可运行：

自动回忆 — 每次会话的第一条消息到达时，系统会自动调用 recall，并将检测到的主题作为查询。近期记忆也会通过资源 memoraeu://context 加载，并注入会话上下文。

自动记忆 — 当 Claude 检测到持久信息（偏好、决定、个人经历、技术约束）时，会自主调用 remember，无需等待用户提出要求。随后会以一条简短、不显眼的消息进行确认。

系统提示词注入 — 首次调用 recall 时，完整的行为系统提示词会注入 Claude 的上下文，从而在本次会话剩余时间内强化自动记忆规则。

此行为直接编码在工具描述中。Claude 模型会在使用工具时遵循这些指令，无需额外配置。

去重与压缩

存储记忆前，MCP 会通过向量相似度检查近似重复项：

相似度	操作
≥ 94 %	忽略记忆 — 检测到完全重复项
85–94 %	记录警告，但仍存储记忆
< 85 %	按常规存储记忆

长记忆（> 300 个字符）会在加密前由 Mistral 压缩，从而减少 Token 消耗并提升搜索相关性。压缩会在明文状态下进行，早于内容加密 — 服务也绝不会看到未经压缩的原文。

自托管

API 是开源的。使用 Docker 部署自己的实例：

git clone https://github.com/pquattro/memoraEu
cd memoraEu
docker compose up -d

---

License

MIT © 2026 MemoraEU