What is Mcp Memory Plugin

mcp_memory_plugin is a Python-based memory plugin that utilizes SQLite for persistent data storage, allowing users to manage and store information across different sessions.

Use cases

Use cases include loading saved memories at the start of a chat, saving important information for future reference, and managing conversation points effectively.

How to use

To use mcp_memory_plugin, create a .env file with the MEMORY_DB_PATH variable pointing to your SQLite database. Use commands like ‘memory://load’ to load saved memories or save new information under specific categories.

Key features

Key features include persistent storage using SQLite, easy configuration through environment variables, and the ability to save and retrieve memories during chat sessions.

Where to use

mcp_memory_plugin can be used in applications that require memory management, such as chatbots, personal assistants, and any software needing persistent data storage.

Memory Plugin

A Python-based memory plugin that uses SQLite for persistent storage.

Overview

This plugin provides memory storage functionality using SQLite as the backend database. It’s designed to store and manage data persistently across sessions.

Setup

1. Environment Configuration

   Create a .env file in the root directory with the following configuration:

   MEMORY_DB_PATH=/path/to/your/memory.sqlite
   
   

   You can use the provided .env.example as a template:

   cp .env.example .env
   

2. Dependencies

   The project requires Python and uses SQLite for data storage. Make sure you have Python installed on your system.

Configuration

1. rename .env.example to .env and edit the values to your needs:

2. Locate claude_desktop_config.json and use the template below to add “MQTT Bridge” to the mcpServers section.
   MacOs: ~/Library/Application Support/Claude/claude_desktop_config.json
   Windows: C:\Users<username>\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memory_recall": {
      "command": "/path/to/python3",
      "args": [
        "/path/2/your/cloned/repository/memory_plugin.py"
      ]
    }
  }
}

The SQLite database path is configured through the MEMORY_DB_PATH environment variable. This should point to where you want the SQLite database file to be stored.

Current configuration:

MEMORY_DB_PATH=/path/to/your/dabatase.sqlite

Usage

Basic Usage

Refer to the @mcp.resource and @mcp.tool decorated functions in the memory_plugin.py file

Examples to type in the chat:

• memory://load to load the saved memories at new chat start
• Save into the memory, under aNewName category, the following: a new message with important info to remember
• Save the relevant points of the conversation into the memory under aNewName category

Development

When contributing to this project:

1. Make sure to not commit sensitive information
2. Keep your .env file private
3. Use .env.example for sharing template configurations

License

This project is licensed under the MIT License.