Memex

本地优先、隐私优先的个人上下文引擎，专为 LLM 打造。

TypeScript · Swift · MCP · OpenAPI 3.1.0 · Cloudflare Tunnel

大多数 AI 助手对你一无所知。每次新对话都是从头开始——它们不知道你在读什么、存了哪些链接、写过哪些笔记、下载过哪些文件。

Memex 解决了这个问题。它是一个在你 Mac 上运行的后台守护进程，被动地将你的数字行为索引到本地数据库。之后，任何 LLM——桌面上的 Claude、手机上的 ChatGPT——都能通过标准接口访问这个数据库。没有云存储。没有第三方服务器。一切数据都停留在你自己的机器上。

会捕获哪些内容

• 屏幕截图 —— 使用 Apple 的 Vision framework（Swift）在本地 OCR

• 剪贴板 —— 持续监控；YouTube 链接会自动获取转录文本，Twitter 链接抓取推文内容

• 下载内容 —— PDF、Markdown 文件、CSV 在下载时即被解析并索引

• Apple Notes —— 通过 AppleScript 定期同步

• 浏览器历史 —— Safari、Chrome、Arc、Brave 和 Edge 的访问记录（所有 profile），每 30 分钟同步一次，并过滤掉搜索、登录、localhost 等干扰

• 来自手机的链接 —— 通过 HTTP Shortcuts 从 Android 直接分享 → 用 POST 发送到本地 API

秘密不会进入保险库。 从密码管理器（1Password、Bitwarden、KeePass 等）复制的内容会基于 App 识别和 org.nspasteboard.ConcealedType 标记被跳过；而那些“看起来像秘密”的内容——AWS 密钥、GitHub/Slack/Stripe 令牌、JWT、私钥块、PASSWORD= 赋值、生成密码样式的字符串——都会在存储前被过滤掉。

剪贴板噪音会自清理：完全相同的条目会被合并，原始剪贴板条目会在 30 天后过期（可通过 OMNICONTEXT_CLIPBOARD_MAX_AGE_DAYS / OMNICONTEXT_CLIPBOARD_MAX_COUNT 配置）。而富内容——笔记、下载、截图、历史记录——则永远不会被清除。

Related MCP server: memory-mcp

工作原理

[Screenshots / Clipboard / Notes / Downloads]
              ↓
     Memex Daemon (Node.js)
              ↓
     SQLite + FTS5 (db.sqlite)
       ↙              ↘
 MCP Server          HTTP Server :4322
 (stdio)             (Bearer auth)
     ↓                    ↓
Claude Desktop      Cloudflare Tunnel
                         ↓
                   ChatGPT Mobile /
                   Android Share Sheet

数据库使用 SQLite（借助 Node 内置的 node:sqlite，没有任何原生依赖），并配有 FTS5 全文索引。搜索采用 BM25 排序，覆盖标题、内容和来源 URL，并且叠加了近期性和文档类型的加权——无需嵌入模型，无 API 调用，完全离线。WAL 模式保证守护进程和 MCP 进程可安全并发访问。旧版本中的 db.json 会在首次启动时自动迁移。

数据库通过两个接口同时对外提供服务：

• 本地 MCP 服务器（stdio 传输），供 Claude Desktop 以及 Cursor 这类支持 MCP 的编辑器使用

• HTTP 服务器，基于免费的 Cloudflare Tunnel 分享，供 ChatGPT Custom Actions 和手机端数据采集使用

安装配置

系统要求： macOS（采集功能依赖 Vision OCR、AppleScript、launchd 等 macOS 原生特性）和 Node.js ≥ 22.5（Memex 使用了内置的 node:sqlite；在旧版 Node 上会直接退出并给出明确提示）。

git clone https://github.com/arnavbee/memex
cd memex
npm install && npm run build

# Configure your API key
cp .env.example .env
# Edit .env and set OMNICONTEXT_API_KEY (only needed for the HTTP API/tunnel)

# Start the daemon once (foreground)
npm start

# ...or install it as a launchd agent: starts at login, restarts on crash
npm run install-daemon    # logs land in ~/.omnicontext/daemon.log
npm run uninstall-daemon  # stop + remove (database untouched)

# Expose to mobile (optional)
cloudflared tunnel --url localhost:4322

权限（系统设置 → 隐私与安全）：请为 node 二进制授予 完全磁盘访问权限（用于访问 Safari 历史），以及 自动化 → Notes（用于 Apple Notes 同步）。Chromium 内核浏览器（Chrome、Brave、Arc、Edge 等）无需这些授权。

Claude Desktop —— 在 ~/Library/Application Support/Claude/claude_desktop_config.json 中配置，然后重启 Claude Desktop：

{
  "mcpServers": {
    "memex": {
      "command": "node",
      "args": ["/path/to/memex/dist/mcp-standalone.js"]
    }
  }
}

请使用 mcp-standalone.js 而不是 index.js——Claude Desktop 只需要查询接口。index.js 是完整的捕获守护进程；如果运行两次，会导致重复捕获剪贴板，并冲突到当攻击 4322 端口。同样的配置也适用于 Cursor 和 any MCP 客户端。

ChatGPT Custom Actions —— 将存储库中的 openapi.json 导入到你的 GPT action schema 中，将 server URL 指向你的 Cloudflare Tunnel，并携带 Authorization: Bearer <your OMNICONTEXT_API_KEY>。

Android 分享面板 —— 在 HTTP Shortcuts 中创建一个 POST 请求到 https://<your-tunnel>/ingest，请求头用同一 Bearer 令牌，正文用分享的文本，然后把它添加到分享菜单。今后你在手机上分享的一切都会进入保险库。

使用

无需学习任何命令。只要守护进程在运行，你照常数字生活就行——复制链接、截个图、下载 PDF——之后用日常语言向你的 AI 提问即可：

• “我上周读的那篇关于 attention 的文章是什么？”

• “找到我下载的关于 Python 面试的 PDF 到哪里去了？”

• “我今天早上复制了什么？

• “那个 Karpathy 的视频有没有讲 fine-tuning？”（YouTube 链接会自动索引字幕）

• “删掉那条包含我地址的剪贴板记录”

Claude 会通过 MCP 发现这些工具并自己调用：search_vault、get_recent_assets、get_asset_by_id、delete_asset、sync_browser_history、sync_notes_now、sync_recent_files。能真正让 vault 增值的关键习惯是：当你看到自己之后想找的东西，复制它——这就是你的整个归档系统。

验证是否正常运行：npm test 会运行测试套件；tail -f ~/.omnicontext/daemon.log 可以实时看到捕获过程；刚复制段文字后问 Claude “我刚才复制了什么？”，就是端到端检查。

那些排查过程让人抓狂的问题

ChatGPT 的工具结果限制为 1MB。 直接返回 PDF 全文会让 action 触发 ResponseTooLargeError 崩溃。现在，我们会在服务端把所有返回内容截断为最多 2000 个字符。

Claude Desktop启动时 MCP 连接断连。 因为 HTTP 服务器先于 MCP transport 初始化。我们调整了启动顺序并增加了重试日志。

动态内容会拦截抓取。 cosmos.so、Instagram、需要登录的网站——@mozilla/readability 从它们其中提取不到任何内容。现在，系统不会静默失败，而是写入一条带时间戳和源 URL 的“URL stub”，LLM 至少能确认该链接已保存。

Android 没有 Universal Clipboard。 iCloud 剪贴板同步只支持 Apple 设备。为此，我们把手机分享路由改成了 HTTP Shortcuts → Cloudflare Tunnel → 本地接收 API。

为什么选择这些方案

SQLite 而不是扁平 JSON —— v1 使用的是原子替换的 db.json；当守护进程和 MCP 服务器两个进程为了读取和修改而竞争时，尤其是在每次搜索都整个重新解析文件时，问题就暴露了。好在 Node 内置的 node:sqlite 自带 FTS5 和 WAL，因此在新版本中采用了零依赖的修复。旧 db.json 会自动迁移。

BM25 而不是 embeddings —— 嵌入模型要么需要本地 GPU 支持，要么依赖 API 往返。两者都会破坏“离线优先”原则。FTS5 的 BM25 毫秒级就能得到结果，而且对“常见的个人检索查询场景”效果很好，因为查询通常很具体。

Cloudflare Tunnel 而不是 ngrok —— 无需注册、无需账户、没有带宽限制，而且域名在整个会话期间保持不变。免费的 ngrok 不仅会在重启后更换域名，还会限制连接速率。