memento-mcp

memento-mcp

Knowledge graph memory system built on Neo4j with semantic search, temporal awareness.

361
Stars
56
Forks
2
Releases

Overview

Memento MCP is a scalable, high-performance knowledge graph memory system designed for LLMs. It provides long-term ontological memory with semantic retrieval, contextual recall, and temporal awareness, enabling any MCP client that supports the model context protocol to access persistent memory. Built on Neo4j, it unifies graph storage and vector search, delivering efficient semantic search through vector embeddings (OpenAI embedding models) and cosine similarity, with configurable thresholds and cross-modal search. Entities are core nodes with embeddings and complete version history; relations connect entities with strength, confidence, and rich metadata, and are versioned over time. Features include non-destructive updates, time-based filtering, and change tracking. The MCP API exposes tools for managing entities, observations, relations, and graph operations (read_graph, search_nodes, open_nodes) along with semantic search and embedding retrieval. Integration with Claude Desktop is documented, with example configurations for both real and local development. Advanced capabilities include confidence decay, adaptive hybrid search strategies, and extensive metadata support, plus diagnostics and debugging tools for development and operations. The project emphasizes persistence, resilience, and semantic memory for memory-enabled LLM workflows.

Details

Owner
gannonh
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Semantic Search

Find semantically related entities using vector embeddings (OpenAI embedding models) and cosine similarity with configurable thresholds; supports cross-modal search, multi-model embeddings, contextual retrieval, and a hybrid search mode that blends vector and keyword results.

Temporal Awareness

Track complete history of entities and relations with point-in-time graph retrieval, full version history, time-based filtering, and non-destructive updates that preserve historical state.

Confidence Decay

Relations decay in confidence over time with configurable half-life, minimum floors, reinforcement when reinforced by observations, and support for reference-time-based decay.

Advanced Metadata

Rich metadata support for entities and relations including source, confidence, strength, temporal metadata, custom tags, structured data, query support, and an extensible schema.

MCP API Tools

Comprehensive MCP API primitives for creating and updating entities and relations, managing observations, and performing graph operations (read_graph, search_nodes, open_nodes) plus semantic search and embedding retrieval.

Diagnostics and Debug Tools

Vector search diagnostics, embedding generation checks, detailed logging, and debug commands (diagnose_vector_search, force_generate_embedding) available especially when DEBUG is enabled.

Claude Desktop Integration

Integration guidance and configuration for Claude Desktop (and other MCP clients), including example claude_desktop_config.json and recommended prompts for memory-aware usage.

Audience

LLM developersBuilding memory-enabled copilots and assistants using MCP model context protocol
AI teamsIntegrate persistent memory and semantic search into AI apps and assistant workflows
MCP clientsExamples include Claude Desktop, Cursor, and Github Copilot clients used with MCP

Tags

knowledge-graphmemoryLLMmodel-context-protocolNeo4jvector-searchsemantic-searchtemporal-awarenessversion-historymetadataembeddingsOpenAI-embeddingsClaude-DesktopMCP-apiintegration