Memory-Plus

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.

Installation

1. Prerequisites

• Google API Key: Obtain from Google AI Studio and set as GOOGLE_API_KEY in your environment:

  # macOS/Linux
  export GOOGLE_API_KEY="<YOUR_API_KEY>"
  
  # Windows (PowerShell)
  setx GOOGLE_API_KEY "<YOUR_API_KEY>"
  

• UV Runtime: Required to serve the MCP plugin.

  pip install uv
  

  Or install via shell scripts:

  # 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 One-Click Setup

Click the badge below to automatically install and configure Memory-Plus in VS Code (Insiders):

This will add the following to your settings.json:

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

For cursor, go to file -> Preferences -> Cursor Settings -> MCP and add the following:

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

For Cline add the following to your cline_mcp_settings.json:

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

remember to add the GOOGLE_API_KEY to your secrets / environment variables.

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.

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

Or If you prefer using this MCP in an actual Chat Session. There is a template chatbot in 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        

setup the fastagent.config.yaml and fastagent.secrets.yaml with your own API keys.

# Run the agent
uv run agent_memory.py

RoadMap

• Memory Update
• Improved prompt engineering for memory recording
• Better Visualization of Memory Graph
• 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

License

This project is licensed under the MIT License. See LICENSE for details.