MCP Prose Memory

mcp散文记忆

MCP客户端的持久内存。

mcp-prose-memory 为代理提供了一个小而耐用的地方来保存会话中的事实。它将内存存储为JSON格式，按节对事实进行分组，并公开了一个用于谨慎添加、删除、替换和查看操作的工具。

它是为内存而构建的，这些内存应该能够在重启后幸存下来，而不会变成一个松散的文本文件，慢慢变形。

变更日志· 贡献 · 安全

特性

• 具有稳定模式的JSON内存存储
• 通过临时文件替换进行原子写入
• 原子事实操作：添加、删除、替换、查看
• 分段上下文组织
• 不区分大小写的重复检测
• 对删除和替换进行严格的行号验证
• 对较旧或部分JSON文档进行自动规范化
• 限制：每节30个事实，每个事实300个字符
• 通过环境变量配置存储路径

安装

运行时间： 节点>=18.

npm install -g mcp-prose-memory

或者用npx运行：

npx mcp-prose-memory

配置

默认存储为 ~/.mcp-prose-memory/memory.json.用以下命令覆盖它 MEMORY_PATH.

如果您使用了具有特定于客户端的默认内存位置的旧版本，请将该JSON文件移动到新的默认路径或设置 MEMORY_PATH 到现有文件。

桌面客户端

将这样的服务器条目添加到MCP客户端配置中：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["mcp-prose-memory"]
    }
  }
}

CLI客户端

将这样的服务器条目添加到CLI MCP配置中：

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["mcp-prose-memory"]
    }
  }
}

自定义内存位置

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["mcp-prose-memory"],
      "env": {
        "MEMORY_PATH": "/path/to/your/memory.json"
      }
    }
  }
}

记忆文件

内存文件是JSON，每个部分都有事实数组：

{
  "version": 4,
  "updated": "2025-01-15T10:30:00.000Z",
  "sections": {
    "work": ["Fact 1", "Fact 2"],
    "personal": ["Lives in Berlin", "Prefers dark mode"],
    "top_of_mind": [],
    "history": ["Completed project X"],
    "instructions": ["Be concise"]
  }
}

如果文件不存在，服务器将从一个空文档开始。如果文件是无效的JSON，服务器将失败操作，而不是擦除内存。

工具

记忆

用于所有内存操作的单一工具。这 command 参数选择动作。

命令：

视图

显示所有记忆或按部分筛选。

{"command": "view"}
{"command": "view", "section": "work"}

添加

在章节中添加一个事实。

{"command": "add", "section": "personal", "fact": "Lives in Berlin"}

移除

按行号删除事实。

{"command": "remove", "section": "work", "line": 3}

替换

按行号更新事实。

{"command": "replace", "section": "top_of_mind", "line": 1, "fact": "Working on new project"}

memory_context

返回会话初始化的完整内存文档。由钩子自动调用。

{}

章节

发展

git clone https://github.com/gabrimatic/mcp-prose-memory.git
cd mcp-prose-memory
npm ci
npm test
npm run check

npm test 构建TypeScript源代码并运行存储级和真正的MCP stdio冒烟测试。 npm run check 还运行生产依赖性审计，并使用以下命令验证npm包内容 npm pack --dry-run.

prepublishOnly 在发布之前运行相同的检查。

项目支持

• 变化： 更改日志.md
• 贡献： 贡献.md
• 安全报告： 安全.md
• 问题：

开发者

通过 索罗什

许可证

麻省理工学院