用于可审计代理内存和快速检索的 Git 原生 MCP 服务器
okf-agent-memory 由 Okf Memory 提供，是一个 MCP 服务器，为 AI 编码代理提供持久的、可审计的记忆。该工具将项目知识映射到基于 Git 的语料库，并提供程序化的检索和写入端点，以便代理可以读取和记录任务上下文，而无需不透明的后端。它将记忆存储为可人类阅读的文件，放置在代码库中，并为 MCP 客户端暴露协议接口。旨在为需要可追踪、集成到代码库中的项目记忆的 AI 开发人员和工程团队构建代理工作流。
你实际上可以用它做什么任务？
该工具实现了开放知识格式 v0.2，将一个存储库转换为自我验证的知识语料库，因此代理过程可以将结构化笔记与源文件并存。这种设计取代了依赖于单独向量存储的 RAG 方法，通过将记忆保持为可读的项目工件，使代理的推理痕迹可审计且可管理，使用项目现有的审查和历史工具。
与手动操作相比，检索的准确性如何？
该工具运行一个内存中的 BM25 词汇索引，测量在 300 微秒以下 的排名，涵盖标题、元数据、标签和正文，实现近乎即时的本地查找，无网络延迟。渐进式披露返回紧凑的、以任务为中心的切片，通常约为 300 个标记，项目状态表明选择性检索可以将编码任务的提示上下文膨胀减少高达 90 百分比。
它需要什么文件格式和存储布局？
该系统期望人类可读的 Markdown 文件放置在 Git 存储库内的知识目录下，并使用 YAML 元数据标记信任层，区分人类验证的条目与代理草稿。由于记忆是源控制下的纯文本，标准 Git 命令如 diff 和 blame 可用于审查和恢复记忆更改，适合用于代码的相同审查工作流程。
它需要外部服务或特殊基础设施吗？
该应用程序作为单个、零依赖的 Go 二进制文件发布，冷启动时间小于 4 毫秒，并在 macOS、Linux 和 Windows 上运行。它向兼容客户端（包括 Claude Desktop 和 Cursor）公开 MCP 操作，如 okf_search、okf_show 和 okf_create。搜索和检索在本地操作，无需嵌入 API 调用，开发者将其描述为确定性和离线，避免运行时 LLM 调用进行查找。
最适合接受以仓库为先的代理记忆的工程团队
该应用程序适合那些优先考虑可审计、本地项目上下文的人工智能开发人员和工程团队，并且能够将记忆纳入其源代码控制工作流程。如果您的用例依赖于基于嵌入的语义相似性而不是词汇排名，请期待权衡。将该工具与正常的代码审查实践配对，以验证代理生成的草稿，并保持项目记忆与人类审查的知识一致。
