Memory MCP

A knowledge-graph-based memory system for AI agents that enables persistent information storage between conversations.

Features

• Persistent memory storage using a knowledge graph structure
• Entity-relation model for organizing information
• Tools for adding, searching, and retrieving memories

Tools

The system provides the following MCP tools:

• load_knowledge_graph(): Retrieves the entire knowledge graph
• add_entities(entities): Adds new entities to the memory
• add_relations(relations): Creates relationships between entities
• add_observations(entity_name, observations): Adds observations to existing entities
• delete_entities(entity_names): Removes entities from memory
• delete_relations(relations): Removes relationships
• search_nodes(query): Searches for entities and relations matching a query
• open_nodes(names): Retrieves specific entities and their relationships

Usage

Run the agent with:

uv run memory_agent.py

The agent will automatically:

1. Load its memory at the start of conversations
2. Reference relevant information during interactions
3. Update its memory with new information when the conversation ends

Exit a conversation by typing q.

Configuration

Set the memory storage location with the MEMORY_FILE_PATH environment variable (defaults to memory.json).