mcpField
P
purmemo

purmemo

本地服务
github.com/purmemo-ai记忆与知识24 天前更新

关于 purmemo

pūrmemo 是为 AI 工具提供记忆的服务,可在不同会话间延续用户背景并保存对话。它通过 MCP 工具支持保存、搜索和回忆记忆,还能查看人物与项目的变更历史。

主要功能

  1. 01保存并搜索对话记忆
  2. 02加载用户和项目背景
  3. 03查看人物与项目的日期变更
  4. 04连接兼容 MCP 的工具

适用场景

  1. 01找回先前对话中的决定
  2. 02在会话开始时加载正在进行的工作
  3. 03查看项目细节随时间的变化

MCP 相关

MCP 服务提供保存对话、回忆记忆、获取详情、查看变更和加载用户背景的工具。可连接托管的 Streamable HTTP 服务,也可通过连接器在本地运行。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"purmemo-ai-purmemo": {
"command": "npx",
"args": [
"-y",
"purmemo-mcp"
]
}
}
}
启动命令npx -y purmemo-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmpurmemo-mcp12.9.5

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
tagsarray否用于分类的标签
titlestring否此对话记忆的标题
priorityenum否此记忆的优先级low | medium | high
conversationIdstring否持续更新文档模式的可选唯一标识符。如果提供的 conversationId 对应的记忆已存在,则更新该记忆,而不是创建新记忆。用于维护随时间更新的单条对话记忆。
conversationContentstring是完整的对话记录——至少 500 个字符。请包含讨论的所有内容。

详细介绍

pūrmemo

npm version npm downloads Tests License: MIT

为你的 AI 工具提供记忆。 Claude 会记得你是谁、正在做什么,以及你上次说过什么——在每个会话、每个平台上都是如此。

只想在浏览器中的 ChatGPT 或 Claude.ai 里使用?请改用 Chrome 扩展。


30 秒完成安装

1. 将以下内容粘贴到终端

Mac 或 Linux:

curl -fsSL https://app.purmemo.ai/install | sh

Windows(PowerShell):

irm https://app.purmemo.ai/install.ps1 | iex

安装就这么简单。脚本会处理所有事情——如果你尚未安装 Node,它会为你安装,设置 purmemo 命令,并在完成后告知你。

2. 输入 purmemo
purmemo

浏览器会打开。登录(或创建免费账户)。页面提示完成后,关闭标签页。

3. 重启 Claude

退出并重新打开 Claude Desktop(或 Claude Code)。pūrmemo 现在已连接。

看到以下类似标题时,就表示运行成功:

pūrmemo v15.7.20 · [email protected] · Free · 0 memories

试着在对话结束时说“保存这个”,或者在新对话开始时问“我之前在做什么?”


如果遇到问题

找不到 purmemo 命令? 关闭并重新打开终端,然后再试一次。新命令有时需要重启 Shell 才能生效。

看到“Failed to read token”或“bad decrypt”? 运行:

purmemo --update && purmemo init

这会清除过期凭据并让你重新登录。(已在 v15.7.20+ 中修复——如果你使用的是较早版本,只需执行一次。)

还有其他问题? 请在 github.com/purmemo-ai/purmemo-mcp/issues 提交问题——我们会逐一查看。


功能介绍

  • 记住所有内容 — 保存任意对话,之后输入你记得的内容即可找回。
  • 了解你是谁 — 你的角色、项目和技术栈会自动载入每个新会话。
  • 告诉你发生了哪些变化 — 针对某个人、项目或事物询问 what_changed,即可获取带日期的历史记录:过去的情况、后续替代它的内容,以及发生时间。
  • 随处可用 — Claude Code、Claude Desktop、Cursor、Windsurf、Zed,以及任何支持 MCP 的工具。

你最常用的三个斜杠命令:

输入内容执行操作
/save保存当前对话。稍后使用相同标题 → 更新同一条记忆。
/recall <topic>使用日常语言搜索你的记忆。
/context在会话开始时使用——载入你的身份信息以及上次正在做的事情。

其他安装方式

我已经安装了 Node.js
npm install -g purmemo-mcp && purmemo

或者,无需全局安装即可运行一次:

npx purmemo-mcp@latest init
Claude Desktop — 托管版(推荐,无需设置)

打开 Claude Desktop → Settings → Developer → Edit Config,然后添加:

{
  "mcpServers": {
    "purmemo": {
      "url": "https://mcp.purmemo.ai/mcp/messages",
      "transport": "streamable-http"
    }
  }
}

重启 Claude Desktop。首次使用时,系统会提示你通过 OAuth 登录。

Claude Desktop — 本地版(高级)

从 app.purmemo.ai → Settings → API Keys 获取 API 密钥,然后编辑:

  • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "purmemo": {
      "command": "npx",
      "args": ["-y", "purmemo-mcp"],
      "env": { "PURMEMO_API_KEY": "your-api-key-here" }
    }
  }
}

保存后重启 Claude Desktop。

Cursor / Windsurf / Zed

Cursor — 编辑 ~/.cursor/mcp.json:

{ "mcpServers": { "purmemo": { "command": "npx", "args": ["-y", "purmemo-mcp"], "env": { "PURMEMO_API_KEY": "your-api-key" } } } }

Windsurf — 编辑 ~/.codeium/windsurf/mcp_config.json(格式与上文相同)。

Zed — 编辑 ~/.config/zed/settings.json,在 context_servers 下添加:

{ "context_servers": { "purmemo": { "command": { "path": "npx", "args": ["-y", "purmemo-mcp"], "env": { "PURMEMO_API_KEY": "your-api-key" } } } } }

定价

方案价格回忆次数保存次数
Free$0每月 50 次无限
Pro$19/月无限无限

面向开发者

想了解技术细节?内容都在这里:

  • 默认列出的工具 — 共 5 个:save_conversation、recall_memories、get_memory_details、what_changed、get_user_context。简短的列表有助于助手选对工具。环境变量标志可添加更多工具:
    • PURMEMO_SESSIONS_BETA=1 — 添加 search_past_sessions(测试版):搜索你过去 AI 会话的原始转录,查找实际说过或决定过的内容。由 purmemo-next 提供服务,地址为 PURMEMO_READ_BASE_URL;若未设置,则使用 PURMEMO_SESSIONS_URL;再未设置,则使用 https://next.purmemo.ai。
    • PURMEMO_ADMIN=1 — 添加管理工具(get_acknowledged_errors、save_investigation_result、get_investigations)。
    • PURMEMO_LEGACY_TOOLS=1 — 恢复已暂停的工具(save_artifact、commit、快照工具、list_clusters、discover_related_conversations、run_workflow、list_workflows、共享、任务、测试结果等)。在暂停期间调用这些工具时,它们会告知你应改用什么。
  • 一台机器上使用多个账户(例如个人和工作账户,每个账户都通过 purmemo-mcp-setup add 连接)。服务仍会以当前激活的账户启动,并将其作为每次调用、钩子和自动捕获的默认账户。当本地有两个或更多已登录账户时,核心工具会增加一个可选的 account 参数(仅可从这些已登录账户中选择;其他值会在任何网络调用前被拒绝),并会列出 transfer_memory,用于在账户之间转移一条记忆。使用非默认账户的调用会标注账户名称,并记录到 ~/.purmemo/account-audit.jsonl,但不包含内容或密钥。程序可通过 purmemo-ops(accounts、whoami、save、recall、transfer)使用相同的边界机制;该工具始终要求明确指定账户。托管(远程)模式不会提供此功能;设置 PURMEMO_MULTI_ACCOUNT=0 可将其关闭。参见 ADR-040。
  • 工具、资源和提示词参考 — 服务可提供的所有 MCP 工具,包括已暂停的工具。
  • 持续更新的文档语义 — mode='append' 与 mode='replace'、分块行为,以及 ADR-036/038 的详细信息。
  • 身份层 — 加载到每个会话中的认知指纹。
  • 架构决策(ADR) — 每项设计决策及其背景和权衡。
  • 安装脚本的源代码 — 如果你想查看,运行前请先阅读。

链接


许可证

本仓库中的 MCP 连接器代码采用 MIT 许可证。pūrmemo 平台、API 和后端均为专有产品。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。