<!-- 徽标 -->

Memory-Plus

一个轻量级、本地的检索增强生成（RAG）内存存储系统，适用于MCP代理。Memory-Plus允许您的代理记录、检索、更新和可视化持久“记忆”——笔记、想法和会话上下文——跨越多个运行。

🏆 第一名 在 Infosys剑桥AI中心黑客马拉松！

主要功能

• 记录记忆：保存用户数据、想法和重要上下文。
• 检索记忆：通过关键词或主题搜索过去的条目。
• 最近的记忆：快速获取最后的 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 嵌入API，因此对于您来说是 完全免费 的！

<details> <summary><b>设置Google API密钥示例</b></summary>

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

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

</details>

UV 运行时 需要用于服务MCP插件。

<details> <summary><b>安装UV运行时</b></summary>

pip install uv

或者通过shell脚本安装：

# 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"

</details>

VS Code 一键设置

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

这将在您的 settings.json 中添加以下内容：

  {
    "mcpServers": {
      //..., 您的其他MCP服务器
      "memory-plus": {
        "command": "uvx",
        "args": [
          "-q",
          "memory-plus@latest"
        ],
      }
    }
  }

对于 cursor，转到 文件 -> 首选项 -> 光标设置 -> MCP 并添加上述配置。 如果您没有将 GOOGLE_API_KEY 添加到您的秘密/环境变量中，可以添加如下：

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

就在 memory-plus 字典中的 args 数组之后。

对于 Cline，在您的 cline_mcp_settings.json 中添加以下内容：

{
  "mcpServers": {
    //..., 您的其他MCP服务器
    "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 中有一个模板聊天机器人。

# 克隆仓库
git clone https://github.com/Yuchen20/Memory-Plus.git
cd Memory-Plus

# 安装依赖
pip install uv
uv pip install fast-agent-mcp
uv run fast-agent setup        

设置 fastagent.config.yaml 和 fastagent.secrets.yaml 文件，使用您自己的API密钥。

# 运行代理
uv run agent_memory.py

发展路线图

• 记忆更新
• 改进的记忆记录提示工程
• 更好的记忆图可视化
• 文件导入
• 远程备份！
• 内存管理的Web界面

如果您有任何功能请求，请随时通过添加新问题或在 功能请求 中添加新条目来提出。

许可证

本项目根据 Apache 许可证 2.0 授权。详情见 LICENSE。

常见问题解答

1. 为什么memory-plus不起作用？

• Memory-plus有一些依赖项，在第一次下载时可能会比较慢。通常需要大约1分钟才能获取所有必需的内容。
• 一旦依赖项安装完毕，后续使用将会快得多。
• 如果您遇到其他问题，请随时在仓库上打开一个新的问题。

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

• 只需将MCP JSON文件添加到您的MCP设置中。
• 一旦添加，memory-plus将在需要时自动激活。