Supports containerized deployment with volume mounting for persistent storage
Used for installation via repository cloning
Hosts the repository, issues, and documentation wiki for the project
Supports deployment to Google Cloud Platform using provided deployment scripts
MCP Persistent Memory Server
A Model Context Protocol (MCP) server that provides persistent graph memory with automatic disk storage. Perfect for building knowledge graphs, storing entity relationships, and maintaining context across sessions.
Features
- Persistent Storage: Automatically saves graph data to disk
- Multiple Deployment Options: Run locally or deploy to cloud
- MCP Compatible: Works with Claude Desktop, Cursor, and other MCP clients
- Timestamped Backups: Automatic backup rotation
- Fast Indexed Lookups: Map-based indices for quick searches
- Multiple Export Formats: JSON, CSV for entities and relations
- Remote Access: HTTP/WebSocket server for cloud deployment
- RESTful API: Direct HTTP endpoints for convenience
Quick Start
Local Installation
Add to Cursor
Edit ~/.cursor/mcp.json
:
Usage
Creating Entities
Creating Relations
Searching Nodes
Getting Statistics
REST API
When running in HTTP mode:
Cloud Deployment
Deploy to Google Cloud
Docker Deployment
Using Remote Server
Add to Cursor config:
Storage Structure
Environment Variables
MEMORY_STORAGE_DIR
: Directory for storing graph data (default:./data/memory
)MAX_BACKUPS
: Maximum number of backup files to keep (default: 10)PORT
: HTTP server port (default: 8080)HOST
: HTTP server host (default: 0.0.0.0)
Development
API Reference
MCP Tools
create_entities
: Create new entities in the graphcreate_relations
: Create relations between entitiessearch_nodes
: Search entities by queryread_graph
: Read the entire graphopen_nodes
: Get specific nodes by nameadd_observations
: Add observations to existing entitiesdelete_entities
: Delete entities and their relationsdelete_relations
: Delete specific relationsget_stats
: Get graph statisticsexport_graph
: Export in various formatsclear_graph
: Clear all data
HTTP Endpoints
GET /health
: Health checkGET /info
: Server information and statsPOST /api/entities
: Create entitiesPOST /api/relations
: Create relationsGET /api/search?q=query
: Search nodesGET /api/graph
: Get full graphGET /api/stats
: Get statisticsGET /api/export?format=json|csv-entities|csv-relations
: Export data
License
MIT
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
Support
- Issues: https://github.com/dirkenglund/mcp-persistent-memory/issues
- Documentation: https://github.com/dirkenglund/mcp-persistent-memory/wiki
Built with ❤️ for the MCP ecosystem
This server cannot be installed
Provides persistent graph memory with automatic disk storage for building knowledge graphs, storing entity relationships, and maintaining context across sessions.
Related MCP Servers
- -securityAlicense-qualityA basic implementation of persistent memory using a local knowledge graph. This lets Claude remember information about the user across chats.Last updated -926,18758,023TypeScriptMIT License
- -securityAlicense-qualityProvides knowledge graph functionality for managing entities, relations, and observations in memory with strict validation rules to maintain data consistency.Last updated -6PythonMIT License
- -securityAlicense-qualityA persistent memory implementation using a local knowledge graph that lets Claude remember information about users across conversations.Last updated -4PythonMIT License
- -securityFlicense-qualityEnables storage and retrieval of knowledge in a graph database format, allowing users to create, update, search, and delete entities and relationships in a Neo4j-powered knowledge graph through natural language.Last updated -Python