Structured Memory

结构化记忆 MCP 服务

一个基于模型上下文协议（MCP）的 MCP 服务，通过 Markdown 文件提供结构化、特定领域的记忆管理。它尤其适用于围绕特定关注领域持续开展的项目，让你能够随着时间推移积累有价值的上下文。例如，旅行规划、研究项目、房地产搜索、投资论点、产品规划和职业发展等聚焦领域。

为什么选择结构化记忆？

传统的 MCP 记忆服务会对零散的对话片段进行语义搜索。这对于常规信息回忆很有效，但无法满足需要有条理、按类别整理信息的聚焦项目的需求。

结构化记忆则维护着持续更新的文档，其中的内容经过结构化整理，你可以像使用个人笔记本一样浏览、更新和跟踪，只不过有 AI 助手帮忙。

记忆文档以 Markdown 文件的形式存储，主要由大模型在从对话中学习、逐步构建丰富上下文时自动更新。

典型用法

1. 让大模型客户端为你的聚焦项目创建一份记忆文档 Create a new travel advisor memory document and tell me how to use it. This should start empty and grow over time.

2. 为该领域的对话创建一个新项目。将提供的使用说明添加到项目上下文中

   注意：即使所有工具都给出建议，大模型有时还是不会向你显示安装说明。如果遇到这种情况，请继续要求大模型显示安装说明，它应该会照做。

3. 新的聊天对话会先检查项目记忆中可用的信息。你的大模型会随着时间推移更新这份记忆，从而积累有价值的上下文。

4. 你也可以按需提示大模型添加或调整记忆文件。让大模型向你询问相关信息也很有帮助（例如：“问我一些问题，了解我的旅行偏好”）

安装

选项 1：从 npm 安装（发布后）

npm install -g @nmeierpolys/mcp-structured-memory

选项 2：从源代码安装

git clone https://github.com/nmeierpolys/mcp-structured-memory.git
cd mcp-structured-memory
npm install
npm run build

配置

用于 Claude Desktop

在 claude_desktop_config.json 文件中添加以下条目：

{
  "mcpServers": {
    "mcp-structured-memory": {
      "command": "npx",
      "args": ["@nmeierpolys/mcp-structured-memory"]
    }
  }
}

可用工具

• create_memory - 创建新的记忆文档，可选择添加初始内容
• list_memories - 列出所有可用的记忆文档
• get_memory_summary - 获取记忆文档的概要
• get_section - 获取记忆文档中的特定章节
• get_full_memory - 获取记忆文档的完整内容
• search_within_memory - 在记忆文档中搜索信息
• update_section - 更新记忆文档的整个章节
• add_to_list - 向列表章节添加一项
• update_list_item - 更新列表中的现有项目
• move_list_item - 在不同列表章节之间移动项目

灵活的结构

记忆文档支持你需要的任何结构。AI 会根据你的使用场景帮助你整理章节。常见示例：

• 旅行规划：目的地、行程、住宿、活动、餐厅、旅行贴士、预算跟踪
• 研究项目：研究问题、文献综述、方法论、研究结果、数据来源、后续步骤
• 房地产搜索：搜索条件、在售房源、已看房产、已排除房产、市场洞察、经纪人联系信息

示例：自动构建记忆

User: "Create a new Minnesota trip memory document and tell me how to use it. This should start empty and grow over time."

Claude: "I've created a travel memory document for your Minnesota trip. As we discuss your plans, I'll automatically update it with destinations, timing, preferences, and other details I learn about your trip."

User: "I want to see fall colors, go hiking, try local cuisine, and visit both the North Shore and the Twin Cities."

Claude: "I've noted your priorities in the memory: fall foliage viewing, hiking opportunities, local restaurants, North Shore destinations, and Twin Cities attractions. I'll keep track of specific recommendations as we explore options."

[Later conversation]
User: "What hiking trails have good fall colors?"

Claude: "Based on our previous discussions, I see you're focused on fall colors in Minnesota. Let me suggest some trails and I'll add the best ones to your travel memory..."

备份和版本控制

服务会在重大更新前自动创建带时间戳的备份。

存储位置

记忆文档以 Markdown 文件的形式存储在：

• macOS：~/Library/Application Support/mcp-structured-memory/
• Windows：%LOCALAPPDATA%\mcp-structured-memory\
• Linux：~/.local/share/mcp-structured-memory/