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: Agent 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.
Shared memory for your AI tools: tasks, notes and context every tool can read and write over MCP.
Persistent AI memory shared across Claude, ChatGPT, coding agents, and compatible MCP clients.
