MCP-Memory 是一个模型上下文协议（MCP）服务器，为 AI 代理（如 Claude Desktop、Cursor、Antigravity、Windsurf 或 Codex）提供持久的长期记忆功能。内存记录使用开放知识格式（OKF v0.2）标准格式化，并通过本地 SQLite 实例（支持 FTS5 全文搜索）进行索引，以实现快速的键值查找、标签过滤和内容搜索。 快速通道：直接跳转到快速开始 主要特性 会话间持久状态：使 AI 代理能够读取、存储、搜索和删除在聊天轮次和会话中持续存在的有状态记忆片段。 OKF 标准合规性：以 OKF v0.2 Markdown 文档格式存储每个内存条目，包含 YAML 前言（type、key、namespace、tags、generated、sources、verified、status、stale_after），严格遵循 SPEC.md 和 OKF_RULES.md。 双层架构：可浏览的人类 OKF 目录：自动将每个内存转储并同步到磁盘，作为記憶/包目录中的原始 .md 文件，同时包含分层的 index.md 逐步披露文件（根 index.md 版本化为 okf_version: "0.2"）和 log.md 更新历史跟踪。 高性能 SQLite 索引：SQLite FTS5（全文搜索）和自动触发器用于不到 20 毫秒的键查找和即时关键词搜索。 命名空间隔离：支持上下文分离（例如 user/preferences、project/architecture、default）。 零样板设置：快速设置向导（python3 setup.py）自动配置已安装的 MCP 工具（Antigravity、Claude、Cursor、Windsurf、Codex）。 MCP 工具 服务器向交互代理公开四个主要 MCP 工具： 1. memory_store 存储或更新 OKF v0.2 格式的内存记录。 参数： - key（字符串，必填）：内存的唯一标识符或路径（例如 user/preferences/coding_style 或 project/architecture）。 - content（字符串或对象，必填）：要存储的核心信息。 - project_root（字符串，必填）：活动项目根目录的绝对路径（例如 /Users/user/Projects/my-app）。 - tags（字符串数组，可选）：用于过滤的分类标签。 - namespace（字符串，可选，默认值："default"）：范围/命名空间。 - concept_type（字符串，可选，默认值："Agent Memory"）：OKF 概念类型（例如 Metric、Playbook、Attested Computation）。 - title（字符串，可选）：显示名称。 - description（字符串，可选）：一句话总结。 - resource（字符串，可选）：底层资产的规范 URI。 - status（字符串，可选，默认值："stable"）：生命周期状态（draft | stable | deprecated）。 - stale_after（字符串，可选）：ISO 日期（YYYY-MM-DD）。 - sources（对象数组，可选）：来源 [{resource、id、title、author、usage_count、last_modified}]。 - verified（对象数组或对象，可选）：验证事件 [{by、at}]。 - generated_by（字符串，可选）：遵循演员约定的参与者标识符（<producer>/<version>，human:<id>，process:<id>）。 2. memory_retrieve 按键和命名空间检索特定内存。 参数： - key（字符串，必填）：要查找的内存键。 - project_root（字符串，必填）：活动项目根目录的绝对路径。 - namespace（字符串，可选，默认值："default"）：范围/命名空间。 3. memory_search 查找匹配关键字、标签或命名空间过滤器的内存。 参数： - project_root（字符串，必填）：活动项目根目录的绝对路径。 - query（字符串，可选）：针对键、前言和内容的关键字搜索查询。 - tags（字符串数组，可选）：按特定标签过滤。 - namespace（字符串，可选）：限制搜索范围到命名空间。 - limit（整数，可选，默认值：10）：结果的最大数量。 5. memory_get_last AGENT DIRECTIVE（会话开始）：检索最后记录的会话检查点（system/last_memory)，让 AI 代理在打开项目或开始会话时立即知道工作停留在何处。 参数： - project_root（字符串，必填）：活动项目根目录的绝对路径。 - namespace（字符串，可选，默认值："default"）：范围/命名空间。 6. memory_update_last AGENT DIRECTIVE（里程碑与进展）：在完成里程碑、进行关键更改或暂停工作时更新规范的会话检查点（system/last_memory）。 参数： - content（字符串或对象，必填）：简短说明或结构化字典，概括进展并引用关键内存文件。 - project_root（字符串，必填）：活动项目根目录的绝对路径。 - namespace（字符串，可选，默认值："default"）：范围/命名空间。 - summary（字符串，可选）：实现的里程碑的一句话描述。 OKF（开放知识格式）结构 每个存储的内存严格遵循 OKF v0.2 规范（SPEC.md 和 OKF_RULES.md）： --- - type : Agent Memory - title : Coding Style - key : user/preferences/coding_style - namespace : default - tags : - preferences - style - status : stable - generated : by : mcp-memory/0.2.0 at : '2026-...