--- title: "基于Cloudflare Workers与MCP协议构建个人专属的AI持久化记忆系统，解决Context空白痛点" description: "学习如何利用Cloudflare Workers、Vectorize与MCP协议构建自托管的AI持久化记忆系统（Second Brain）。在Claude、Gemini和Obsidian之间实现多Agent上下文共享。" canonical_url: "https://techvoyage.dev/zh/article/use-cloudflare-as-ai-memory" last_updated: "2026-10-20T09:53:52.040Z" --- ## 持久化AI记忆对智能体（Agent）的重要性 随着AI助手逐渐融入我们的日常生活与工作，我们经常会遇到“空白上下文”的问题（Blank Context Issue）。上周已经确认的决策在开启新对话后便被遗忘，这迫使我们不得不一遍又一遍地输入相同的技术栈细节，并在每个新会话中重新设置用户偏好。 与其每次都从零开始，我们需要构建一个能够持续演进、深入理解用户决策的记忆系统，从而彻底消除重复输入上下文的烦恼。 ## 自托管 AI 记忆系统 vs. 内置 AI 记忆功能 虽然许多AI智能体或客户端（如 ChatGPT、Claude 等）自带了内置记忆功能，但我们很少在所有场景下只使用单一智能体。我们可能会用 Claude 来设计和规划项目架构，用 Kimi 来编写代码，用 ChatGPT 进行深度的背景研究。然而，这些不同的智能体之间无法直接共享上下文，所有记忆依然被孤立在各自的生态黑盒中。 从软件工程的角度来看，我们并不信任无法控制的黑盒。我们需要的是一个可观察、可审计且完全处于自己掌控之下的 AI 记忆系统。开源项目 [Second Brain](https://github.com/Tech-Voyage-Dev/second-brain-cloudflare/tree/main)（Fork 自 [https://github.com/rahilp/second-brain-cloudflare）提供了一个支持模型上下文协议（Model](https://github.com/rahilp/second-brain-cloudflare%EF%BC%89%E6%8F%90%E4%BE%9B%E4%BA%86%E4%B8%80%E4%B8%AA%E6%94%AF%E6%8C%81%E6%A8%A1%E5%9E%8B%E4%B8%8A%E4%B8%8B%E6%96%87%E5%8D%8F%E8%AE%AE%EF%BC%88Model) 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 仓库](https://github.com/Tech-Voyage-Dev/second-brain-cloudflare) 页面，点击 `Deploy to Cloudflare` 按钮。 [[![GitHub 页面上突出显示的 Deploy to Cloudflare 部署按钮](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/deploy-to-cloudflare-button.webp)]] 2. 填写弹出的 Cloudflare Worker 配置表单。 ![Cloudflare Workers 部署配置表单](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-deployment-form.webp) 3. 在 Dimensions（维度）输入 '384'，Metric（度量指标）选择 'cosine'，然后点击 Deploy 按钮。 ![Cloudflare Vectorize 向量数据库创建与维度设置](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-vectorize-configuration.webp) 4. 部署成功后，以下是 Cloudflare Workers 平台中 Second Brain 实例的概览信息： ![已部署的 Second Brain Worker 实例概览主页](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-second-brain-overview.webp) 5. 点击 'Settings'（设置），然后点击 'AUTH_TOKEN' 环境变量旁的编辑图标，以创建一条高强度的访问令牌： ![Cloudflare Worker 变量设置中高亮显示的 AUTH_TOKEN](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-settings.webp) 6. 点击 'Rotate'（轮换）链接，以便能输入新的安全值： ![AUTH_TOKEN 变量修改与秘钥轮换界面](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-rotate.webp)![在 AUTH_TOKEN 值字段中输入生成的随机安全字符串](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/cloudflare-worker-auth-token-value-input.webp) 7. 在 macOS 终端中运行 `openssl rand -base64 32` 命令来生成一个随机的安全字符串，并将其复制粘贴到 'Value' 输入框中。 8. 点击 'Deploy' 按钮，使新配置的 'AUTH_TOKEN' 正式生效。 9. 在浏览器中打开您刚刚创建的 Second Brain Worker 访问域名： ![包含 Bearer Token 输入框的 Second Brain Web 登录界面](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-login.webp) 10. 在 `Bearer token` 输入框中填入刚才创建的 'AUTH_TOKEN'，然后点击 'Connect' 按钮登录 Web 控制台。 ### 通过 MCP 协议集成 Claude Desktop 1. 在 Claude Desktop 客户端中点击 'Customize'（自定义）按钮。 ![Claude Desktop 界面中指向 Customize 自定义按钮的位置](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-customize-button.webp) 2. 点击 'Developer'（开发者）选项，手动编辑本地的 MCP 配置文件： ![Claude Desktop 开发者设置菜单中用于打开 MCP 配置文件的选项](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-developer-menu.webp) 3. 在 `claude_desktop_config.json` 的 `mcpServers` 字段中加入以下配置代码块： ```json "second-brain": { "command": "npx", "args": [ "mcp-remote", "https:///mcp", "--header", "Authorization: Bearer " ] } ``` ![包含 Second Brain 远程服务的 Claude Desktop MCP 配置文件](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-mcp-config-json.webp) 4. 重启 Claude Desktop 并检查 'Local MCP servers' 列表，状态应显示为 'running'（运行中）。 ![Claude Desktop 客户端中显示为运行（running）状态的的 Second Brain MCP 服务](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-mcp-status-running.webp) ### 通过 MCP 协议集成 Claude Code - 在终端中运行以下命令以添加该远程 MCP 服务： ```shell claude mcp add --transport http second-brain https:///mcp ``` - Claude Code 会自动检测到该端点需要 OAuth 身份验证，并在您的默认浏览器中打开登录页面，供您输入并验证刚才创建的 `AUTH_TOKEN`。 - 在本地的 `~/.claude` 目录下创建 `CLAUDE.md` 文件，并将 [CLAUDE_INSTRUCTIONS.md](https://github.com/rahilp/second-brain-cloudflare/blob/main/AI_Instructions/CLAUDE_INSTRUCTIONS.md) 文件中的引导词和规则完整写入其中。 ### 通过 MCP 协议集成 Gemini CLI 1. 将以下 MCP 设定信息加入您本地的 './.gemini/settings.json' 文件： ```json "second-brain": { "httpUrl": "https:///mcp", "oauth": { "enabled": true } } ``` 1. 启动 Gemini CLI 客户端。 ### 在不同 AI 智能体中测试 Second Brain 效果 1. 在 **Claude Desktop** 中，如果我们只是进行简单的品牌色调偏好设置，此时默认并不会调用外部的 Second Brain 服务： ![在未启用 Second Brain 记忆层时在 Claude Desktop 中进行的首次偏好设置测试](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-first-run-brand-palette.webp) 2. 如果我们只是输入 'remember' 等常规词，由于其尚未触发特定提示词引导，**Claude Desktop** 此时仅会调用本地内置的 `memory_user-edits` 工具，并不会同步到云端的持久化记忆层。 ![Claude Desktop 默认调用本地内置用户编辑工具而忽略云端 Second Brain](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-remember-built-in-tool-fallback.webp) 3. 而当我们在配置了规则引导的 **Claude Code** 终端中，输入以下具体指令时，系统便成功地在后台触发并调用了 Second Brain 工具： ```text Remember Our brand palette uses `#1a1a2e` as primary, `#16213e` as secondary, and `#e94560` as accent. Never use pure black." ``` ![Claude Code 终端窗口显示成功触发并写入 Second Brain 远程记忆](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-code-second-brain-mcp-called.webp) 4. 登录 **Cloudflare Workers 控制台** 查看 Second Brain 的数据库，确认这些颜色信息已成功同步并存储在云端： ![在 Second Brain 控制台 Web UI 中验证已成功保存的品牌色配置数据](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-color-verification.webp) - *Claude Code 之所以能够自动无缝工作，得益于项目目录下的 CLAUDE_INSTRUCTIONS.md 文件。该文件让智能体能够理解并关联包含 'Second Brain' 关键字的记忆流程。* 5. 在 **Claude Desktop** 中若想达到相同效果，我们需要在提示词中显式提及 'Second Brain' 相关的指引，以强制智能体读取或写入这一持久化记忆图层。 ![在提示词中显式提及 'Second Brain' 关键字以触发远程记忆读写](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/claude-desktop-second-brain-explicit-trigger.webp) 6. 同样地，在 **Gemini CLI** 交互中，我们也需要提到 'Second Brain' 关键字，以唤醒并触发其对应的远程 MCP 工具。 ![Gemini CLI 终端命令行交互中成功触发 Second Brain 读写](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/gemini-cli-second-brain-trigger.webp) - *如果您仿照 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（第三方插件） ![Obsidian 系统设置面板中指向第三方社区插件的入口](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-settings-community-plugins.webp) 2. 点击 Browse（浏览） 按钮。 ![Obsidian 第三方插件应用中心并高亮显示的 Browse 浏览按钮](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-community-plugins-browse.webp) 3. 检索关键词 'Second Brain Sync'。 ![在 Obsidian 第三方插件市场中搜索 Second Brain Sync 插件](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-community-plugins-search-second-brain.webp) 4. 点击 'Install' 进行安装，然后点击 'Enable' 启用该插件。 ![在 Obsidian 中点击安装并启用 Second Brain Sync 插件](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-install-and-enable.webp) #### 配置 Obsidian 插件 1. 进入 Obsidian 客户端 Settings（设置） → 选中 Second Brain Sync 插件配置页面： 2. 准确填写您的 Worker 的端点「URL」和刚才创建的「Auth token（身份令牌）」： ![在 Obsidian 插件配置页面中输入 Worker URL 和 AUTH_TOKEN 身份凭证](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-configuration-credentials.webp) 3. 点击 'Test' 按钮来验证网络连接是否畅通： ![Obsidian 插件连接测试返回成功（Success）提示](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-connection-test-success.webp) 4. 配置具体的同步策略。设定您的同步标签「Sync tag」并开启「Auto-sync on save（保存时自动同步）」功能： ![在 Obsidian 插件中配置特定同步标签并启用保存时自动同步](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-plugin-sync-behavior-settings.webp) 5. 在 Obsidian 知识库中新建一篇笔记，并为其附带您配置好的同步标签（例如： `second-brain`）： ![在 Obsidian 中创建一篇带有 'second-brain' 标签的待同步本地笔记](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/obsidian-note-with-sync-tag.webp) 6. 笔记保存后，其内容已成功触发并自动同步到在 Cloudflare 上运行的自托管 Second Brain 实例中： ![在云端 Second Brain 控制台 Web UI 中验证已成功同步过来的 Obsidian 笔记](https://inimages.techvoyage.dev/articles/Use%20Cloudflare%20as%20AI%20memory/second-brain-web-ui-synced-note-verification.webp) ## 总结与展望 Second Brain 记忆系统为困扰当前 AI 生态的最大痛点之一 —— 长期上下文遗忘与记忆断层，提供了一套极为优雅的开源解决方案。通过将自托管项目与 CloudflareWorkers 弹性、全球分布的 Serverless 基础设施深度结合，我们得以在边缘网络上轻松架设起一条低延迟、高响应速度的个人语义记忆网关。得益于 MCP 这一开放的标准，这条记忆脉络如今已能无缝流动、并被移植共享于各种主流的 AI 助手和开发终端之间。 Obsidian 专属同步插件的加入，更是将这套架构完美融合进了个人日常的知识管理（PKM）流程。您平时随手记录的杂乱卡片或开发速记，能被有选择地提炼并重构，转化为可被 AI 完美解析的结构化上下文。 将私有化部署、高精度的语义向量搜索以及开放式的 MCP 集成标准相融合，Second Brain 不仅仅是一层记忆的外挂，它正向我们展示着一个由用户个人掌握核心数据所有权，安全、独立、互联的未来 Agent 生态系统基石。 ## 参考资料： - [https://www.thesecondbrain.dev/](https://www.thesecondbrain.dev/) - [https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works](https://github.com/rahilp/second-brain-cloudflare/wiki/How-It-Works) - [Connect to AI Clients](https://github.com/rahilp/second-brain-cloudflare/wiki/Connect-to-AI-Clients) - [Second Brain Obsidian Plugin](https://github.com/rahilp/second-brain-cloudflare/wiki/Obsidian-Plugin) - [https://github.com/rahilp/second-brain-obsidian-plugin](https://github.com/rahilp/second-brain-obsidian-plugin)