butler-memory-mcp

Butler Memory MCP 是一个 MCP 服务器，把 AI Butler Framework 的分层记忆服务以标准 Model Context Protocol 接口暴露给任意 MCP 客户端。

核心能力

将 PostgreSQL 作为底层存储，提供带修订历史与审计证据的长期记忆层。Agent 只能记住用户明确要求记住的内容——推断出的信息只会成为待确认的候选，不会静默写入。

工具接口

通过 MCP 协议暴露六个工具：memory_list / memory_search 检索记忆（自动排除 private/secret 级别）；memory_revisions 查看不可变修订历史；memory_create / memory_revise / memory_archive 执行显式写入并绑定修订版本；memory_candidates / memory_candidate_accept / memory_candidate_reject 处理推断候选。

隐私保障

写操作依赖 MCP 工具描述约束和敏感度上限，不等于框架 Web 端的强确认卡片。HTTP API 仅允许 loopback 访问，数据 durable 但备份恢复功能尚未实现。

安装运行

安装后配置三个环境变量（PostgreSQL 连接 URL、记忆属主 UUID、设备 ID），即可通过 stdio 模式连接 DSH、Claude Code、Codex 等主流 MCP 客户端。

适用场景

需要在 AI Coding Agent 中维护持久化项目上下文、偏好设置和技术规范的企业或团队；希望对 Agent 记忆写入保持人工审计能力的开发者。