Acts as the shared cloud memory store: the server reads and writes memories, versions, authors, and tombstones in a MySQL 8.0+ instance (e.g. Tencent Cloud MySQL) that stays on an internal network while agents reach it only through the HTTPS API.
Provides the local client-side cache and durable operation queue in ~/.membridge/, enabling offline-first reads, TTL snapshots with stale marking, and pending/conflict tracking that survives restarts before syncing to the cloud.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MemBridge remember that the atlas project uses Bun and MySQL"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
让多个 Agent 共用你自己的云记忆。 本地有效缓存优先，缺失/过期查询云端，研究所得先持久化到本地，再同步。
基于 Claude-Mem 的分层回忆与部分脱敏代码改造。0.1.6 是可运行的自托管原型：MySQL 云服务、SQLite 本地客户端、MCP、共享 skill。已有安装先读 0.1.6 升级说明，使用方式见 工具说明。
flowchart LR
A[Codex / Claude / 其他 Agent] --> B[Skill + 本地 MCP]
B --> C[SQLite 缓存和待同步]
B -->|HTTPS + 各自令牌| D[云记忆 API]
D --> E[腾讯云 MySQL]Bun 1.4.2+，云端 MySQL 8.0+；本地支持 Windows/Linux，Docker 部署示例针对 Linux 腾讯云 CVM。
git clone https://github.com/sunqfeng/membridge.git
cd membridge
bun install --frozen-lockfile
bun test
bun run typecheck无云配置时 bun run mcp 可运行本地模式，记录保存到 ~/.membridge/、状态 pending，尚不能跨机器共享。
Related MCP server: nuzo-memory
按 部署指南 建立独立数据库和 agent 令牌，配置 MYSQL_URL、MEMBRIDGE_TOKENS_FILE 后 bun run server。客户端只访问 HTTPS，MySQL 保持内网/本机访问。令牌绑定 namespace、agent、项目白名单；相同 namespace/project 才共享。
bun scripts/install-skill.ts codex
# 或 bun scripts/install-skill.ts claude再按 客户端配置 添加本地 stdio MCP。skill 指导何时读写，MCP 执行存储；只装其中一个不能形成完整体验。安装器遇到已有 skill 会停止。
工具 | 功能 |
search | 有效查询快照优先，再查云端；返回索引 |
recent | 无需关键词，按项目/类型查看最近记忆 |
get_memories | 重分配正文预算；offset/nextOffset 分页，续读绑定 version/bodyHash |
timeline | 云端时间线索引 |
remember | 本地保存并尝试同步，更新要求当前版本 |
forget | 本地隐藏并排队云端删除 |
sync / status | 重试 pending；retryFailed=true 重试 blocked/rejected；报告冲突 |
discard_pending | 经用户选择丢弃本地操作，不删除云端 |
rebase_pending | 预览本地/云端冲突；凭一次性 confirmToken 和版本确认重投 |
同项目用稳定 slug，例如 investment-research，不用机器路径。同事实更新复用 ID 和 version，独立事实新 ID。来源、证据日期和有效期由 agent 提供。
队列跨重启，启动立即同步，每 30 秒重试最多 50 项，每批最多 4 个独立操作并发；临时故障后停止新派发并退避 5 秒。remember/forget 的身份验证与同步共用 2 秒前台网络等待预算，未知权限可暂存 pending，验证后才上传；MCP sync 也最多等待 2 秒。剩余操作继续后台执行。幂等上传，冲突保留，不强行覆盖。
TTL 默认 60 秒，最高 1 小时；空查询结果同样缓存，读取详情不清查询快照，refresh=true 强制查询。TTL 内不是实时一致。
云故障和零命中分开；旧缓存标明 stale；timeline 需要网络。
中文片段匹配，只查询标题和正文的生成列，分页到足够有效结果或穷尽，返回最多 30 项，按最近更新排序。引号/换行可匹配；尚无全文索引和向量语义检索，大库扫描可能较慢。
删除清正文与回执正文、保留墓碑；其他离线缓存、聊天上下文、用户备份不立即清除。
脱敏在本地及云端写入前执行，不保证覆盖所有秘密。URL 密码中的斜杠需编码为 %2F；含未编码斜杠的异常连接串不保证被识别，避免把端口后的 @ 路径误当密码。
令牌支持 ro/rw（默认 rw）及服务端 tokenSha256；MCP 返回标为 untrusted_evidence，记忆包含作者 agent。
默认不监听私人聊天，不调用后台付费模型；通过 skill 引导显式提炼。用户可另行启用增量聊天归档适配器，自动整理新增可见记录；安装 MCP 本身不会开启采集。
服务为单实例原型，每 agent 每分钟 120 请求，内存限流重启重置。暂无控制台、分布式限流和高可用部署。
bun test
bun run typecheck
bun audit
# 专用临时数据库名称必须以 membridge_test 开头：
MEMBRIDGE_TEST_MYSQL_URL='mysql://test:password@127.0.0.1:3306/membridge_test' bun run test:mysql覆盖中文、隔离、幂等、版本冲突、墓碑、脱敏、离线重启、跨 agent、缓存、HTTP、MCP。未配置测试 MySQL 时集成测试明确跳过；CI 使用独立 MySQL。
This server cannot be deployed
Persistent, inspectable memory for AI agents with lineage, correction, and a hosted MCP endpoint.
Persistent memory for AI agents across Claude, ChatGPT and any MCP client.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
One memory, every AI. A shared, user-owned markdown memory your AI clients read and write over MCP.
