基于Cloudflare Workers与MCP协议构建个人专属的AI持久化记忆系统，解决Context空白痛点

持久化AI记忆对智能体（Agent）的重要性

随着AI助手逐渐融入我们的日常生活与工作，我们经常会遇到“空白上下文”的问题（Blank Context Issue）。上周已经确认的决策在开启新对话后便被遗忘，这迫使我们不得不一遍又一遍地输入相同的技术栈细节，并在每个新会话中重新设置用户偏好。

与其每次都从零开始，我们需要构建一个能够持续演进、深入理解用户决策的记忆系统，从而彻底消除重复输入上下文的烦恼。

自托管 AI 记忆系统 vs. 内置 AI 记忆功能

虽然许多AI智能体或客户端（如 ChatGPT、Claude 等）自带了内置记忆功能，但我们很少在所有场景下只使用单一智能体。我们可能会用 Claude 来设计和规划项目架构，用 Kimi 来编写代码，用 ChatGPT 进行深度的背景研究。然而，这些不同的智能体之间无法直接共享上下文，所有记忆依然被孤立在各自的生态黑盒中。

从软件工程的角度来看，我们并不信任无法控制的黑盒。我们需要的是一个可观察、可审计且完全处于自己掌控之下的 AI 记忆系统。开源项目 Second Brain（Fork 自 https://github.com/rahilp/second-brain-cloudflare）提供了一个支持模型上下文协议（Model Context Protocol，简称 MCP）的持久化自托管 AI 记忆系统。任何兼容 MCP 协议的 AI 智能体（如 Claude、ChatGPT、Kimi Code 等）都可以完美共享相同的上下文记忆库。

如何在 Cloudflare 上构建 Second Brain AI 记忆系统

Second Brain 记忆系统部署在 Cloudflare Workers 之上，其提供了全球分布式、极低延迟的 Serverless 运行基础设施。这使得在 AI 的推理和决策循环中，检索记忆（Recall）及写入等操作能够以近乎零延迟的体验执行。

系统使用 Workers AI 的嵌入（Embedding）模型来生成高维向量。这些嵌入向量存储在 Cloudflare Vectorize 中，这是一项经过高度优化、全球分布式的高性能向量数据库服务。Cloudflare Vectorize 会执行余弦相似度（Cosine Similarity）搜索，以精准匹配具有语义相关性的记忆切片。

Second Brain 还内置了智能的去重与合并机制。只有在内容相似度低于 85% 时，系统才会将其作为新记忆存储；否则，该内容将被拦截或标记为潜在的重复候选。超过 1,600 字符的长文本会被系统在句子或换行符边界处进行合理切分，并保持相邻分片之间有 200 字符的重叠（Overlap），以防丢失上下文语境。随后，每个文本分片都会被单独向量化，从而实现极高精度的语义匹配。

系统为 AI 智能体直接暴露了以下 MCP 工具接口：

• remember：存储想法、决策、偏好及项目整体上下文
• append：为已有的记忆内容追加新的更新或补充信息
• update：完全替换已有的某条记忆内容
• recall：基于语义相似度检索相关记忆，而非死板的关键词精确匹配
• list_recent：浏览最近保存的记忆记录
• forget：永久且彻底地删除某条记忆
• link/connections：明示关联不同的记忆节点（V2 版本提供的图谱功能）

在 Cloudflare 上配置 Second Brain

1. 在 Github 仓库 页面，点击 Deploy to Cloudflare 按钮。 [[]]
2. 填写弹出的 Cloudflare Worker 配置表单。
3. 在 Dimensions（维度）输入 '384'，Metric（度量指标）选择 'cosine'，然后点击 Deploy 按钮。
4. 部署成功后，以下是 Cloudflare Workers 平台中 Second Brain 实例的概览信息：
5. 点击 'Settings'（设置），然后点击 'AUTH_TOKEN' 环境变量旁的编辑图标，以创建一条高强度的访问令牌：
6. 点击 'Rotate'（轮换）链接，以便能输入新的安全值：
7. 在 macOS 终端中运行 openssl rand -base64 32 命令来生成一个随机的安全字符串，并将其复制粘贴到 'Value' 输入框中。
8. 点击 'Deploy' 按钮，使新配置的 'AUTH_TOKEN' 正式生效。
9. 在浏览器中打开您刚刚创建的 Second Brain Worker 访问域名：
10. 在 Bearer token 输入框中填入刚才创建的 'AUTH_TOKEN'，然后点击 'Connect' 按钮登录 Web 控制台。

通过 MCP 协议集成 Claude Desktop

1. 在 Claude Desktop 客户端中点击 'Customize'（自定义）按钮。
2. 点击 'Developer'（开发者）选项，手动编辑本地的 MCP 配置文件：
3. 在 claude_desktop_config.json 的 mcpServers 字段中加入以下配置代码块：

    "second-brain": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<your-worker-url>/mcp",
        "--header",
        "Authorization: Bearer <your-token>"
      ]
    }

4. 重启 Claude Desktop 并检查 'Local MCP servers' 列表，状态应显示为 'running'（运行中）。

通过 MCP 协议集成 Claude Code

• 在终端中运行以下命令以添加该远程 MCP 服务：

claude mcp add --transport http second-brain https://<your-worker-url>/mcp

• Claude Code 会自动检测到该端点需要 OAuth 身份验证，并在您的默认浏览器中打开登录页面，供您输入并验证刚才创建的 AUTH_TOKEN。
• 在本地的 ~/.claude 目录下创建 CLAUDE.md 文件，并将 CLAUDE_INSTRUCTIONS.md 文件中的引导词和规则完整写入其中。

通过 MCP 协议集成 Gemini CLI

1. 将以下 MCP 设定信息加入您本地的 './.gemini/settings.json' 文件：

    "second-brain": {
      "httpUrl": "https://<your-worker-url>/mcp",
      "oauth": {
        "enabled": true
      }
    }

2. 启动 Gemini CLI 客户端。

在不同 AI 智能体中测试 Second Brain 效果

1. 在 Claude Desktop 中，如果我们只是进行简单的品牌色调偏好设置，此时默认并不会调用外部的 Second Brain 服务：
2. 如果我们只是输入 'remember' 等常规词，由于其尚未触发特定提示词引导，Claude Desktop 此时仅会调用本地内置的 memory_user-edits 工具，并不会同步到云端的持久化记忆层。
3. 而当我们在配置了规则引导的 Claude Code 终端中，输入以下具体指令时，系统便成功地在后台触发并调用了 Second Brain 工具：

Remember Our brand palette uses `#1a1a2e` as primary, `#16213e` as secondary, and `#e94560` as accent. Never use pure black."

4. 登录 Cloudflare Workers 控制台 查看 Second Brain 的数据库，确认这些颜色信息已成功同步并存储在云端： - Claude Code 之所以能够自动无缝工作，得益于项目目录下的 CLAUDE_INSTRUCTIONS.md 文件。该文件让智能体能够理解并关联包含 'Second Brain' 关键字的记忆流程。 5. 在 Claude Desktop 中若想达到相同效果，我们需要在提示词中显式提及 'Second Brain' 相关的指引，以强制智能体读取或写入这一持久化记忆图层。 6. 同样地，在 Gemini CLI 交互中，我们也需要提到 'Second Brain' 关键字，以唤醒并触发其对应的远程 MCP 工具。 - 如果您仿照 CLAUDE_INSTRUCTIONS.md 的做法，在本地的 GEMINI.md 文件中添加类似的上下文引导，AI 便可在后台静默调用 Second Brain 记忆层，不再需要您每次都手动输入触发关键字。

浏览器插件与快捷剪辑

• 系统为 Chrome、Firefox 和 Microsoft Edge 浏览器提供了官方插件支持。
• 通过该插件，您可以非常快捷地完成以下操作：
  • 网页一键剪辑 — 一键将当前页面的网页标题与 URL 网址快捷归档到您的 Second Brain 中。
  • 选中文本摘要剪辑 — 选中网页中的任意精彩段落或技术细节后点击剪辑，该摘录便会配合网页标题和 URL 被一并存储。
  • 自由文本速记 — 在保存前直接在插件弹窗中输入额外的补充上下文，或直接附带 #标签；这些标签会被系统自动识别并提取。

通过 Obsidian 插件同步个人本地知识库

• 系统提供了一个 Obsidian 专属插件，支持将您本地 Obsidian Vault（保险库）中的特定笔记完美同步至 Cloudflare 端自托管的 Second Brain 记忆中心。
• 通过配置特定的同步标签，您可以精准控制哪些笔记能够写入您的持久化 AI 上下文库中。

安装 Obsidian 插件

1. 启动 Obsidian 客户端 → 点击 Settings（设置） → Community Plugins（第三方插件）
2. 点击 Browse（浏览） 按钮。
3. 检索关键词 'Second Brain Sync'。
4. 点击 'Install' 进行安装，然后点击 'Enable' 启用该插件。

配置 Obsidian 插件

1. 进入 Obsidian 客户端 Settings（设置） → 选中 Second Brain Sync 插件配置页面：
2. 准确填写您的 Worker 的端点「URL」和刚才创建的「Auth token（身份令牌）」：
3. 点击 'Test' 按钮来验证网络连接是否畅通：
4. 配置具体的同步策略。设定您的同步标签「Sync tag」并开启「Auto-sync on save（保存时自动同步）」功能：
5. 在 Obsidian 知识库中新建一篇笔记，并为其附带您配置好的同步标签（例如： second-brain）：
6. 笔记保存后，其内容已成功触发并自动同步到在 Cloudflare 上运行的自托管 Second Brain 实例中：

总结与展望

Second Brain 记忆系统为困扰当前 AI 生态的最大痛点之一 —— 长期上下文遗忘与记忆断层，提供了一套极为优雅的开源解决方案。通过将自托管项目与 CloudflareWorkers 弹性、全球分布的 Serverless 基础设施深度结合，我们得以在边缘网络上轻松架设起一条低延迟、高响应速度的个人语义记忆网关。得益于 MCP 这一开放的标准，这条记忆脉络如今已能无缝流动、并被移植共享于各种主流的 AI 助手和开发终端之间。

Obsidian 专属同步插件的加入，更是将这套架构完美融合进了个人日常的知识管理（PKM）流程。您平时随手记录的杂乱卡片或开发速记，能被有选择地提炼并重构，转化为可被 AI 完美解析的结构化上下文。

将私有化部署、高精度的语义向量搜索以及开放式的 MCP 集成标准相融合，Second Brain 不仅仅是一层记忆的外挂，它正向我们展示着一个由用户个人掌握核心数据所有权，安全、独立、互联的未来 Agent 生态系统基石。

参考资料：

• https://www.thesecondbrain.dev/
• https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works
• Connect to AI Clients
• Second Brain Obsidian Plugin
• https://github.com/rahilp/second-brain-obsidian-plugin