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=""
# Windows (PowerShell)
setx GOOGLE_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": ""
}刚刚之后 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将在需要时自动激活。
