Memory Plus

Memory-Plus

面向 MCP Agent 的轻量级本地检索增强生成（RAG）记忆存储。Memory-Plus 可让你的 Agent 在多次运行期间记录、检索、更新和可视化持久化的“记忆”——笔记、想法和会话上下文。

🏆 在 Infosys Cambridge AI Centre Hackathon 中荣获第一名！

主要功能

• 记录记忆：保存用户数据、想法和重要上下文。
• 检索记忆：按关键词或主题搜索过往条目。
• 近期记忆：快速获取最近的 N 条内容。
• 更新记忆：无缝追加或修改现有条目。
• 可视化记忆：通过交互式图谱簇揭示关联关系。
• 导入文件（自 v0.1.2 起）：将文档直接导入记忆。
• 删除记忆（自 v0.1.2 起）：移除不需要的条目。
• 关于记忆的记忆（自 v0.1.4 起）：现在我们使用 resources 来教会你的 AI 准确判断何时回忆（以及何时不回忆）过往交互。
• 记忆版本管理（自 v0.1.4 起）：更新记忆时，我们会保留旧版本，以提供完整的历史记录。

安装

1. 前置条件

Google API 密钥 从 Google AI Studio 获取，并将其设置为环境变量 GOOGLE_API_KEY。

请注意，我们只会使用此 API 密钥调用 Gemini Embedding API，因此你可以完全免费使用！

# macOS/Linux
export GOOGLE_API_KEY="<YOUR_API_KEY>"

# Windows (PowerShell)
setx GOOGLE_API_KEY "<YOUR_API_KEY>"

UV 运行时 用于运行 MCP 插件。

pip install uv

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

VS Code 一键设置

点击下方徽章，即可在 VS Code 中自动安装并配置 Memory-Plus：

这会将以下内容添加到你的 settings.json 中：

  {
    "mcpServers": {
      //...,  your other MCP servers
      "memory-plus": {
        "command": "uvx",
        "args": [
          "-q",
          "memory-plus@latest"
        ],
      }
    }
  }

对于 cursor，请前往 file -> Preferences -> Cursor Settings -> MCP，并添加上述配置。 如果你尚未将 GOOGLE_API_KEY 添加到机密信息／环境变量中，可以通过以下方式添加：

"env": {
        "GOOGLE_API_KEY": "<YOUR_API_KEY>"
      }

将其放在 memory-plus 字典中、紧接 args 数组之后。

对于 Cline，请将以下内容添加到你的 cline_mcp_settings.json 中：

{
  "mcpServers": {
    //...,  your other MCP servers
    "memory-plus": {
      "disabled": false,
      "timeout": 300,
      "command": "uvx",
      "args": [
        "-q",
        "memory-plus@latest"
      ],
      "env": {
        "GOOGLE_API_KEY": "${{ secrets.GOOGLE_API_KEY }}"
      },
      "transportType": "stdio"
    }
  }
}

对于其他 IDE，设置方式大致相同。

本地测试与开发

你可以使用 MCP Inspector 在本地测试 memory-plus 服务。

git clone https://github.com/Yuchen20/Memory-Plus.git
cd Memory-Plus
npx @modelcontextprotocol/inspector fastmcp run run .\\memory_plus\\mcp.py

或者，如果你想在实际聊天会话中使用此 MCP，agent.py 中提供了一个模板聊天机器人。

# Clone the repository
git clone https://github.com/Yuchen20/Memory-Plus.git
cd Memory-Plus

# Install dependencies
pip install uv
uv pip install fast-agent-mcp
uv run fast-agent setup        

使用你自己的 API 密钥设置 fastagent.config.yaml 和 fastagent.secrets.yaml。

# Run the agent
uv run agent_memory.py

路线图

• 更新记忆
• 改进记忆记录提示词工程
• 改进记忆图谱可视化
• 导入文件
• 远程备份！
• 记忆管理 Web UI

如果你有任何功能需求，欢迎新建 issue，或在功能需求中添加新条目

许可证

本项目采用 Apache License 2.0 许可。详情请参阅 LICENSE。

常见问题

1. 为什么 memory-plus 无法正常工作？

• memory-plus 有一些依赖项，首次下载时可能会比较慢。通常需要大约 1 分钟才能下载所需内容。
• 安装依赖项后，后续使用会快得多。
• 如果遇到其他问题，欢迎在代码库中提交新问题。

2. 如何在实际聊天会话中使用 memory-plus？

• 只需将 MCP JSON 文件添加到 MCP 配置中。
• 添加后，memory-plus 会在需要时自动启用。