Knowledge Graph Memory Server
Eine grundlegende Implementierung von persistentem Speicher mithilfe eines lokalen Wissensgraphen. Dadurch kann Claude sich Informationen über den Benutzer über Chats hinweg merken.
Kernkonzepte
Entitäten
Entitäten sind die primären Knoten im Wissensgraphen. Jede Entität verfügt über:
- Ein eindeutiger Name (Kennung)
- Ein Entitätstyp (z. B. „Person“, „Organisation“, „Ereignis“)
- Eine Liste von Beobachtungen
Beispiel:
{
"name": "John_Smith",
"entityType": "person",
"observations": ["Speaks fluent Spanish"]
}
Beziehungen
Relationen definieren gerichtete Verbindungen zwischen Entitäten. Sie werden immer im Aktiv ausgedrückt und beschreiben, wie Entitäten miteinander interagieren oder in Beziehung zueinander stehen.
Beispiel:
{
"from": "John_Smith",
"to": "Anthropic",
"relationType": "works_at"
}
Beobachtungen
Beobachtungen sind diskrete Informationen über eine Entität. Sie sind:
- Als Zeichenfolgen gespeichert
- An bestimmte Entitäten angehängt
- Kann unabhängig hinzugefügt oder entfernt werden
- Sollte atomar sein (eine Tatsache pro Beobachtung)
Beispiel:
{
"entityName": "John_Smith",
"observations": [
"Speaks fluent Spanish",
"Graduated in 2019",
"Prefers morning meetings"
]
}
API
Werkzeuge
- Entitäten erstellen
- Erstellen Sie mehrere neue Entitäten im Wissensgraphen
- Eingabe:
entities (Array von Objekten)- Jedes Objekt enthält:
name (Zeichenfolge): EntitätskennungentityType (Zeichenfolge): Typklassifizierungobservations (Zeichenfolge[]): Zugehörige Beobachtungen
- Ignoriert Entitäten mit vorhandenen Namen
- Beziehungen erstellen
- Erstellen Sie mehrere neue Beziehungen zwischen Entitäten
- Eingabe:
relations (Array von Objekten)- Jedes Objekt enthält:
from (Zeichenfolge): Name der Quell-Entitätto (Zeichenfolge): Name der ZielentitätrelationType (Zeichenfolge): Beziehungstyp im Aktiv
- Überspringt doppelte Beziehungen
- Beobachtungen hinzufügen
- Hinzufügen neuer Beobachtungen zu vorhandenen Entitäten
- Eingabe:
observations (Array von Objekten)- Jedes Objekt enthält:
entityName (Zeichenfolge): Zielentitätcontents (Zeichenfolge[]): Neue hinzuzufügende Beobachtungen
- Gibt hinzugefügte Beobachtungen pro Entität zurück
- Schlägt fehl, wenn die Entität nicht existiert
- Entitäten löschen
- Entfernen von Entitäten und ihren Beziehungen
- Eingabe:
entityNames (string[]) - Kaskadierendes Löschen von zugehörigen Relationen
- Stiller Vorgang, wenn die Entität nicht existiert
- Beobachtungen löschen
- Entfernen Sie bestimmte Beobachtungen von Entitäten
- Eingabe:
deletions (Array von Objekten)- Jedes Objekt enthält:
entityName (Zeichenfolge): Zielentitätobservations (Zeichenfolge[]): Zu entfernende Beobachtungen
- Leiser Betrieb, wenn keine Beobachtung vorhanden ist
- delete_relations
- Entfernen Sie bestimmte Beziehungen aus dem Diagramm
- Eingabe:
relations (Array von Objekten)- Jedes Objekt enthält:
from (Zeichenfolge): Name der Quell-Entitätto (Zeichenfolge): Name der ZielentitätrelationType (Zeichenfolge): Beziehungstyp
- Stiller Vorgang, wenn keine Beziehung besteht
- Diagramm lesen
- Lesen Sie den gesamten Wissensgraphen
- Keine Eingabe erforderlich
- Gibt die vollständige Graphstruktur mit allen Entitäten und Beziehungen zurück
- Suchknoten
- Suche nach Knoten basierend auf der Abfrage
- Eingabe:
query (Zeichenfolge) - Sucht in:
- Entitätsnamen
- Entitätstypen
- Beobachtungsinhalt
- Gibt übereinstimmende Entitäten und ihre Beziehungen zurück
- offene_Knoten
- Abrufen bestimmter Knoten nach Namen
- Eingabe:
names (Zeichenfolge[]) - Widerrufsfolgen:
- Angeforderte Entitäten
- Beziehungen zwischen angefragten Entitäten
- Überspringt stillschweigend nicht vorhandene Knoten
Verwendung mit Claude Desktop
Aufstellen
Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:
Docker
{
"mcpServers": {
"memory": {
"command": "docker",
"args": ["run", "-i", "-v", "claude-memory:/app/dist", "--rm", "mcp/memory"]
}
}
}
NPX
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}
NPX mit benutzerdefinierter Einstellung
Der Server kann mit den folgenden Umgebungsvariablen konfiguriert werden:
{
"mcpServers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
],
"env": {
"MEMORY_FILE_PATH": "/path/to/custom/memory.json"
}
}
}
}
MEMORY_FILE_PATH : Pfad zur JSON-Datei im Speicher (Standard: memory.json im Serververzeichnis)
VS Code-Installationsanweisungen
Verwenden Sie für eine schnelle Installation eine der folgenden Ein-Klick-Installationsschaltflächen:
Für die manuelle Installation fügen Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzu. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open Settings (JSON) ein.
Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen. Dadurch können Sie die Konfiguration mit anderen teilen.
Beachten Sie, dass der mcp Schlüssel in der Datei .vscode/mcp.json nicht benötigt wird.
NPX
{
"mcp": {
"servers": {
"memory": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-memory"
]
}
}
}
}
Docker
{
"mcp": {
"servers": {
"memory": {
"command": "docker",
"args": [
"run",
"-i",
"-v",
"claude-memory:/app/dist",
"--rm",
"mcp/memory"
]
}
}
}
}
Systemaufforderung
Die Eingabeaufforderung zur Speichernutzung hängt vom Anwendungsfall ab. Durch Ändern der Eingabeaufforderung kann das Modell die Häufigkeit und Art der erstellten Speicher bestimmen.
Hier ist ein Beispiel für eine Chat-Personalisierung. Sie können diese Eingabeaufforderung im Feld „Benutzerdefinierte Anweisungen“ eines Claude.ai-Projekts verwenden.
Follow these steps for each interaction:
1. User Identification:
- You should assume that you are interacting with default_user
- If you have not identified default_user, proactively try to do so.
2. Memory Retrieval:
- Always begin your chat by saying only "Remembering..." and retrieve all relevant information from your knowledge graph
- Always refer to your knowledge graph as your "memory"
3. Memory
- While conversing with the user, be attentive to any new information that falls into these categories:
a) Basic Identity (age, gender, location, job title, education level, etc.)
b) Behaviors (interests, habits, etc.)
c) Preferences (communication style, preferred language, etc.)
d) Goals (goals, targets, aspirations, etc.)
e) Relationships (personal and professional relationships up to 3 degrees of separation)
4. Memory Update:
- If any new information was gathered during the interaction, update your memory as follows:
a) Create entities for recurring organizations, people, and significant events
b) Connect them to the current entities using relations
b) Store facts about them as observations
Gebäude
Docker:
docker build -t mcp/memory -f src/memory/Dockerfile .
Lizenz
Dieser MCP-Server ist unter der MIT-Lizenz lizenziert. Das bedeutet, dass Sie die Software unter den Bedingungen der MIT-Lizenz frei verwenden, ändern und verbreiten dürfen. Weitere Informationen finden Sie in der LICENSE-Datei im Projekt-Repository.