Spomory
← 所有平台

Claude Desktop

本地一个 JSON 配置文件，云端 OAuth 2.1——两条路都端到端验证过。

Spomory 接入 Claude Desktop 有两种方式：本地 stdio server（免费、隐私、跑在本机）或者云端托管端点（OAuth 2.1 鉴权，记忆跨设备跟着你）。两条路暴露的是同样六个工具。

本地版（stdio）

在 claude_desktop_config.json 里加一段（macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json）。mcpServers 下面这个键就是客户端界面上显示的名字，可以按喜好改，但要连带更新下面「排查方法」里的日志文件名。command 填 uvx——它会按需下载并运行 Spomory，不用你自己装任何东西，也完全绕开 macOS 拦截 ~/Documents 下子进程这个坑：

{
  "mcpServers": {
    "Spomory": {
      "command": "uvx",
      "args": ["--from", "spomory[llm,embedding,mcp]", "spomory-mcp"],
      "env": {
        "LLM_API_KEY": "...",
        "LLM_BASE_URL": "https://api.deepseek.com",
        "LLM_MODEL": "deepseek-v4-flash"
      }
    }
  }
}

如果这个文件已经有别的键，只加 mcpServers 这一项，不要动其他内容，改之前先备份。改完完全退出并重新打开 Claude Desktop 才会生效。

更想要固定、锁定版本的安装，不想依赖 uvx 的按需缓存？可以装到 ~/Documents 之外的虚拟环境里（pip install 'spomory[llm,embedding,mcp]'），然后把 command 直接指向那个虚拟环境的 bin/memory-core-mcp。

验证是否跑通（10 分钟内应该能完成）

  1. 打开 Claude Desktop，新建对话，确认 Connectors/MCP 工具列表里 Spomory 已连接。
  2. 让 Claude 调用 add_memory：「请调用 Spomory 的 add_memory 工具，记住：我在某某公司做后端开发」。
  3. 新建对话，让 Claude 调用 search_memory 查「我在哪里工作」，确认能检索到刚写入的内容。
  4. 让 Claude 调用 forget_memory 删除这条记忆，再重复查询一次，确认已经查不到了。

如果 Claude Desktop 提示「Server disconnected」，真实报错在 ~/Library/Logs/Claude/mcp-server-Spomory.log（文件名跟着 mcpServers 里的键名走）——先看这个文件。

这几个环境变量该填什么？

LLM_API_KEY 是你用来做抽取的那个 OpenAI 兼容服务商的 key——OpenAI、DeepSeek、通义千问等都可以。LLM_BASE_URL 和 LLM_MODEL 不填就默认走 OpenAI；换成 DeepSeek、通义千问或其他任意 OpenAI 兼容服务商，或者一个完全本地的 server（Ollama、vLLM、llama.cpp、MLX）都行：

export LLM_API_KEY=...
export LLM_BASE_URL=https://api.deepseek.com   # 可选，默认 OpenAI
export LLM_MODEL=deepseek-v4-flash             # 可选，默认 gpt-4o-mini
export EMBEDDING_MODEL=BAAI/bge-m3             # 可选，默认 bge-m3
完整本地安装指南（含 macOS 的 ~/Documents 那个坑）→

GitHub 上完整的本地安装指南 →

云端版（OAuth 2.1）

用 OAuth。Settings → Connectors → Add custom connector——名字随便起，URL 填 https://api.yliuai.com/mcp。它会引导你走一遍授权流程；登录方式是邮件魔法链接——填邮箱，点开收到的链接，会跳转回 Claude，此时已连接成功。

端到端验证过：能连上，全部六个工具（包括 forget_all_memory）都会带着正确的单独审批设置显示在 Claude Desktop 的 Connector 工具列表里。

GitHub 上完整的远程接入指南 →

让它真的被用起来

接上工具不代表客户端会主动去用它们——得告诉它在回答之前先调 search_memory，在你说了件值得记住的事之后调 add_memory。SKILL.md 就是干这个的一份简短指令文件。怎么让客户端读到它，每个客户端都不一样：有些会自动扫描 skills 目录（跟 Claude Code 一个路数），有些只有自定义指令/系统提示词这类字段。这个客户端已验证过：

Claude Desktop 不会扫描本地文件夹——它的 Skills 功能是账号级的：Settings → Capabilities → Skills，把 SKILL.md 打包成文件夹或 .zip 上传，之后会同步到你账号下所有的 Claude 界面。

GitHub 上的 SKILL.md →