n1mem-mcp · N1Mem 记忆 MCP Server

powered by T1Mem engine · BYOK（自带 Key）· 零依赖（仅标准库）

让 Claude / Cursor / OpenClaw 之类支持 MCP 的客户端，直接获得 N1Mem 的长期记忆能力。

• memory_write：写入一段记忆（持久化 + 建向量，写入即可召回）
• memory_recall：按自然语言问题召回记忆；返回的 answer 已基于命中记忆接地，retrieved 给出命中的明文记忆
• memory_health：查看服务健康与 provider 可用性

本 Server 是薄层透传：不含任何记忆逻辑，只把工具调用转发到 N1Mem C-2 API（https://api.n1mem.com）。因此零依赖、可塞进任意环境。

安装

pip install n1mem-mcp

获取 Key

试用 Key 当前由 N1Mem 团队发放（自助注册 / 定价页在路上）。拿到形如 tk_xxx 的 Key。

配置（Cursor / Claude / OpenClaw）

把下面片段加进你的 MCP 配置（~/.cursor/mcp.json、Claude 的 claude_desktop_config.json、或 OpenClaw 的 MCP 配置）：

{
  "mcpServers": {
    "n1mem": {
      "command": "n1mem-mcp",
      "env": { "N1MEM_API_KEY": "tk_xxx" }
    }
  }
}

或用模块方式启动（无需 pip install 也可，只要能 import）：

{
  "mcpServers": {
    "n1mem": {
      "command": "python",
      "args": ["-m", "n1mem_mcp"],
      "env": { "N1MEM_API_KEY": "tk_xxx" }
    }
  }
}

环境变量

已知限制（诚实告知）

• 暂无 delete / update 工具（服务端未就绪，故不暴露）；需要删记忆请联系团队。
• health() 可能返回 status: degraded：这是设计使然（部分上游 provider 未配置），核心记忆链路（存储 / 嵌入 / 写入 / 召回）正常。

与 n1mem 的区别