AI导哈

RAG记忆存储

一个轻量级的本地检索增强生成（RAG）记忆存储，用于MCP代理，支持记录、检索、更新和可视化跨运行的持久记忆。

  • by Yuchen20
  • Python
  • 本地部署
  • 56 星标
  • 更新于
在 GitHub 查看 Yuchen20/Memory-Plus

使用说明

Memory Plus

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

🏆 第一名 在 Infosys剑桥人工智能中心黑客马拉松!

主要特点

  • 记录记忆：保存用户数据、想法和重要上下文。
  • 找回记忆：按关键字或主题搜索过去的条目。
  • 最近的回忆：获取最后一个 N 项目快速。
  • 更新记忆：无缝添加或修改现有条目。
  • 想象记忆：显示关系的交互式图形集群。
  • 文件导入 (从v0.1.2开始)：将文档直接摄入内存。
  • 删除记忆 (从v0.1.2开始)：删除不需要的条目。
  • 记忆换记忆 (从v0.1.4开始)：现在我们使用 resources 教你的人工智能何时（何时）回忆过去的互动。
  • 内存版本控制 (从v0.1.4开始)：当记忆更新时，我们保留旧版本以提供完整的历史记录。

安装

1.先决条件

Google API密钥 从…获得 谷歌人工智能工作室 并设置为 GOOGLE_API_KEY 在您的环境中。

请注意，我们将只使用 Gemini Embedding API 使用此API密钥，因此 完全免费 供您使用！

Setup Google API Key Example 
# macOS/Linux
export GOOGLE_API_KEY="<YOUR_API_KEY>"

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

UV运行时间 需要为MCP插件提供服务。

Install UV Runtime 
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"

VS代码一键设置

点击下面的徽章，在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 您可以使用以下命令将其添加到secrets/environment变量中：

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

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

对于 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，您可以在本地测试内存和服务器。

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

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

# Run the agent
uv run agent_memory.py

路线图

  • [x] 内存更新
  • [x] 改进了内存记录的快速工程
  • [x] 更好的内存图可视化
  • [x] 文件导入
  • []远程备份！
  • []用于内存管理的Web UI

如果您有任何功能请求，请随时通过添加新问题或在 功能请求

许可证

该项目根据 Apache许可证2.0。参见 许可证 了解详情。

常见问题解答

1.为什么记忆+不起作用？

  • Memory plus有一些依赖关系，第一次下载时可能会很慢。通常需要大约1分钟来获取所需的一切。
  • 一旦安装了依赖项，后续的使用速度会快得多。
  • 如果您遇到其他问题，请随时在存储库上打开新问题。

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

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

相关 MCP