MemoFS MCP Server

@memofs/mcp-server

         

用于 MemoFS Agent 集成的模型上下文协议服务。

这是什么？

@memofs/mcp-server 包让 AI 编码 Agent（如 Claude Desktop、Cursor、Zed 和 OpenCode）能够通过模型上下文协议（MCP）安全地读取、搜索和更新项目记忆。它封装了核心运行时，并提供 10 个面向模型的工具（4 个记忆动词 + 6 个 AgentFS 会话工具）以及 9 个用于访问记忆、图谱和会话的资源。

主要功能：

• 代码锚定 — memofs.remember 接受可选的 anchor 参数，将记忆绑定到源文件；锚定文件发生变化时，memofs.recall 会显示 stale 标记。
• 记忆衰减检测 — 当记忆超过其类型对应的衰减下限时，召回结果会带有 unverified 标记。
• 会话结果 — memofs_agent_session_complete 接受 outcome、ephemeral 和 reason 参数，用于控制一张 5 行的行为矩阵，以决定是否将记忆提升为持久记忆以及如何清理工作区。

安装

大多数 MCP 客户端会按需通过 npx 调用该服务，无需安装：

npx -y @memofs/mcp-server --help

如果要将该服务安装为开发依赖：

npm install -D @memofs/mcp-server

需要 Node.js >= 22。

或者在客户端配置中直接通过 npx 使用：

npx -y @memofs/mcp-server --help

快速开始

你可以将 MCP 客户端（例如 Claude Desktop、Cursor 或任何 MCP 客户端）配置为通过 stdio 启动该服务。

MCP 客户端配置

{
  "mcpServers": {
    "memofs": {
      "command": "npx",
      "args": [
        "-y",
        "@memofs/mcp-server",
        "--runtime",
        "local",
        "--root",
        "/absolute/path/to/project"
      ]
    }
  }
}

配置与用法

该服务支持两种运行模式（local、hybrid），可通过 --cloud-url 和 --api-key 进行云端同步，并支持严格的 --read-only 标志，在与不受信任的客户端一起使用时阻止会修改数据的工具。

有关所有主流 AI 工具的完整设置说明、公开的工具和资源列表以及运行模式选项，请参阅完整文档。

贡献

有关在 monorepo 中进行格式化、代码检查和测试的详情，请参阅我们的中央贡献指南和开发脚本。

许可证

MIT