T1nker-1220/memories-with-lessons-mcp-server

A basic implementation of persistent memory using a local knowledge graph. This lets Claude remember information about the user across chats and learn from past errors through a lesson system.
## Core Concepts
### Entities
Entities are the primary nodes in the knowledge graph. Each entity has:
A unique name (identifier)
An entity type (e.g., "person", "organization", "event")
A list of observations
Example:
json
"name": "JohnSmith",
"entityType": "person",
"observations": ["Speaks fluent Spanish"]
### Relations
Relations define directed connections between entities. They are always stored in active voice and describe how entities interact or relate to each other.
Example:
json
"from": "JohnSmith",
"to": "Anthropic",
"relationType": "worksat"
### Observations
Observations are discrete pieces of information about an entity. They are:
Stored as strings
Attached to specific entities
Can be added or removed independently
Should be atomic (one fact per observation)
Example:
json
"entityName": "JohnSmith",
"observations": [
"Speaks fluent Spanish",
"Graduated in 2019",
"Prefers morning meetings"
### Lessons
Lessons are special entities that capture knowledge about errors and their solutions. Each lesson has:
A unique name (identifier)
Error pattern information (type, message, context)
Solution steps and verification
Success rate tracking
Environmental context
Metadata (severity, timestamps, frequency)
Example:
json
"name": "NPMVERSIONMISMATCH01",
"entityType": "lesson",
"observations": [
"Error occurs when using incompatible package versions",
"Affects Windows environments specifically",
"Resolution requires version pinning"
],
"errorPattern": {
"type": "dependency",
"message": "Cannot find package @shadcn/ui",
"context": "package installation"
},
"metadata": {
"severity": "high",
"environment": {
"os": "windows",
"nodeVersion": "18.x"
},
"createdAt": "2025-02-13T13:21:58.523Z",
"updatedAt": "2025-02-13T13:22:21.336Z",
"frequency": 1,
"successRate": 1.0
},
"verificationSteps": [
"command": "pnpm add shadcn@latest",
"expectedOutput": "Successfully installed shadcn",
"successIndicators": ["added shadcn"]
## API
### Tools
createentities
Create multiple new entities in the knowledge graph
Input: entities (array of objects)
Each object contains:
name (string): Entity identifier
entityType (string): Type classification
observations (string[]): Associated observations
Ignores entities with existing names
createrelations
Create multiple new relations between entities
Input: relations (array of objects)
Each object contains:
from (string): Source entity name
to (string): Target entity name
relationType (string): Relationship type in active voice
Skips duplicate relations
addobservations
Add new observations to existing entities
Input: observations (array of objects)
Each object contains:
entityName (string): Target entity
contents (string[]): New observations to add
Returns added observations per entity
Fails if entity doesn't exist
deleteentities
Remove entities and their relations
Input: entityNames (string[])
Cascading deletion of associated relations
Silent operation if entity doesn't exist
deleteobservations
Remove specific observations from entities
Input: deletions (array of objects)