Yuchen20/Memory-Plus

A lightweight, local Retrieval-Augmented Generation (RAG) memory store for MCP agents. Memory-Plus lets your agent record, retrieve, update, and visualize persistent "memories"—notes, ideas, and session context—across runs.
> 🏆 **First Place** at the Infosys Cambridge AI Centre Hackathon!
Key Features
* **Record Memories**：Save user data, ideas, and important context.
* **Retrieve Memories**：Search by keywords or topics over past entries.
* **Recent Memories**：Fetch the last *N* items quickly.
* **Update Memories**：Append or modify existing entries seamlessly.
* **Visualize Memories**：Interactive graph clusters revealing relationships.
* **File Import** (*since v0.1.2*)：Ingest documents directly into memory.
* **Delete Memories** (*since v0.1.2*)：Remove unwanted entries.
* **Memory for Memories** (*since v0.1.4*)：Now we use resources to teach your AI exactly when (and when not) to recall past interactions.
* **Memory Versioning** (*since v0.1.4*)：When memories are updated, we keep the old versions to provide a full history.
---
Installation
1. Prerequisites
**Google API Key**
Obtain from Google AI Studio and set as GOOGLE_API_KEY in your environment.
> Note that we will only use the Gemini Embedding API with this API key, so it is **Entirely Free** for you to use!
Setup Google API Key Example
**UV Runtime**
Required to serve the MCP plugin.
Install UV Runtime
Or install via shell scripts:
VS Code One-Click Setup
Click the badge below to automatically install and configure Memory-Plus in VS Code:
This will add the following to your settings.json:
For cursor, go to file -> Preferences -> Cursor Settings -> MCP and add the above config.
If you didn't add the GOOGLE_API_KEY to your secrets / environment variables, you can add it with:
just after the args array with in the memory-plus dictionary.
For Cline add the following to your cline_mcp_settings.json:
For other IDEs it should be mostly similar to the above.
Local Testing and Development
Using MCP Inspector, you can test the memory-plus server locally.
Or If you prefer using this MCP in an actual Chat Session. There is a template chatbot in agent.py.
setup the fastagent.config.yaml and fastagent.secrets.yaml with your own API keys.
RoadMap
- [x] Memory Update
- [x] Improved prompt engineering for memory recording
- [x] Better Visualization of Memory Graph
- [x] File Import
- [ ] Remote backup!
- [ ] Web UI for Memory Management
> If you have any feature requests, please feel free to add them by adding a new issue or by adding a new entry in the Feature Request