OpenSEO
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Self-hosted MCP memory server: a typed knowledge graph on Postgres 16 and pgvector.
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
2/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Engraphy (auf der Seite des Anbieters erstellen) · Installiere zuerst Docker auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Engraphy für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "engraphy": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ENGRAPHY_DATABASE_URL", "ghcr.io/devon-clarkk/engraphy:0.3.0" ], "env": { "ENGRAPHY_DATABASE_URL": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei ENGRAPHY_DATABASE_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Engraphy wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
SettingsDeveloperEdit Config
{
"mcpServers": {
"engraphy": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENGRAPHY_DATABASE_URL",
"ghcr.io/devon-clarkk/engraphy:0.3.0"
],
"env": {
"ENGRAPHY_DATABASE_URL": "your-value"
}
}
}
}Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Engraphy und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Engraphy nutzt, oder ein Werkzeug von Engraphy in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
ENGRAPHY_BIND_HOST Interface the server binds. Containers reach their own loopback only, so a published container sets 0.0.0.0 and puts the boundary at the port publication and the reverse proxy. · Standard 127.0.0.1ENGRAPHY_BIND_PORT Port the server binds inside the container, matching the port in the transport URL. · Standard 8000Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Engraphy noch nicht verbinden
Engraphy läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Engraphy verbinden kann
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Engraphy (auf der Seite des Anbieters erstellen) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Engraphy für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user engraphy --env ENGRAPHY_DATABASE_URL=your-value -- docker run -i --rm -e ENGRAPHY_DATABASE_URL ghcr.io/devon-clarkk/engraphy:0.3.0 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei ENGRAPHY_DATABASE_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Engraphy wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user engraphy --env ENGRAPHY_DATABASE_URL=your-value -- docker run -i --rm -e ENGRAPHY_DATABASE_URL ghcr.io/devon-clarkk/engraphy:0.3.0Ersetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Engraphy sollte in der Liste als verbunden erscheinen
Nutze Engraphy und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Engraphy nutzt, oder ein Werkzeug von Engraphy in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
ENGRAPHY_BIND_HOST Interface the server binds. Containers reach their own loopback only, so a published container sets 0.0.0.0 and puts the boundary at the port publication and the reverse proxy. · Standard 127.0.0.1ENGRAPHY_BIND_PORT Port the server binds inside the container, matching the port in the transport URL. · Standard 8000Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Engraphy (auf der Seite des Anbieters erstellen) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Engraphy für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "engraphy": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ENGRAPHY_DATABASE_URL", "ghcr.io/devon-clarkk/engraphy:0.3.0" ], "env": { "ENGRAPHY_DATABASE_URL": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei ENGRAPHY_DATABASE_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Engraphy wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
In den Einstellungen von Engraphy ist ENGRAPHY_DATABASE_URL leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Engraphy und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Engraphy nutzt, oder ein Werkzeug von Engraphy in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
ENGRAPHY_BIND_HOST Interface the server binds. Containers reach their own loopback only, so a published container sets 0.0.0.0 and puts the boundary at the port publication and the reverse proxy. · Standard 127.0.0.1ENGRAPHY_BIND_PORT Port the server binds inside the container, matching the port in the transport URL. · Standard 8000Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Engraphy (auf der Seite des Anbieters erstellen) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Engraphy für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Docker mit docker --version. Fehlt es, sag mir, dass ich es von https://www.docker.com/products/docker-desktop/ installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "engraphy": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ENGRAPHY_DATABASE_URL", "ghcr.io/devon-clarkk/engraphy:0.3.0" ], "env": { "ENGRAPHY_DATABASE_URL": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei ENGRAPHY_DATABASE_URL "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Engraphy wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
VS Code fragt nach einer Bestätigung; klicke Install
In den Einstellungen von Engraphy ist ENGRAPHY_DATABASE_URL leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Engraphy und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Engraphy nutzt, oder ein Werkzeug von Engraphy in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
ENGRAPHY_BIND_HOST Interface the server binds. Containers reach their own loopback only, so a published container sets 0.0.0.0 and puts the boundary at the port publication and the reverse proxy. · Standard 127.0.0.1ENGRAPHY_BIND_PORT Port the server binds inside the container, matching the port in the transport URL. · Standard 8000Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
Claude Code
claude mcp add --scope user engraphy --env ENGRAPHY_DATABASE_URL=your-value -- docker run -i --rm -e ENGRAPHY_DATABASE_URL ghcr.io/devon-clarkk/engraphy:0.3.0Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"engraphy": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENGRAPHY_DATABASE_URL",
"ghcr.io/devon-clarkk/engraphy:0.3.0"
],
"env": {
"ENGRAPHY_DATABASE_URL": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"engraphy": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENGRAPHY_DATABASE_URL",
"ghcr.io/devon-clarkk/engraphy:0.3.0"
],
"env": {
"ENGRAPHY_DATABASE_URL": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"engraphy": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENGRAPHY_DATABASE_URL",
"ghcr.io/devon-clarkk/engraphy:0.3.0"
],
"env": {
"ENGRAPHY_DATABASE_URL": "your-value"
}
}
}
}ENGRAPHY_DATABASE_URL geheim erforderlich envENGRAPHY_BIND_HOST envENGRAPHY_BIND_PORT envDie Beschreibungen sind noch im englischen Original.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
oci: ghcr.io/devon-clarkk/engraphy:0.3.0Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 15. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto EngraphyLabs bestätigt, dem das Repo gehört
Code zuletzt geändert: vor 3 Tagen
GitHub konnte die Lizenzart nicht erkennen; öffne die Datei, um nachzusehen
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 2 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Das musst du eintragen: ENGRAPHY_DATABASE_URL
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt vor 3 Tagen geändert, und die neueste Version (0.3.0) kam vor 2 Monaten in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker auf deinem Computer.
In derselben Kategorie: OpenSEO, Exa, Mockserver, Microsoft Learn MCP, Docs
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP.
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Search and read Empryo's documentation. Read-only, no auth, no local access.
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
An MCP server giving AI agents associative memory, modelled on the human mind.
Quickstart · Documentation · Tool reference · Design set · Contributing
The name comes from *engraphy*, an old term from memory science for the process of laying down an *engram*, the trace a memory leaves in the brain. Engraphy does that for agents: it checks each new memory against what it already knows before the write lands, merging restatements, linking genuinely new facts, and never silently overwriting. Nothing is deleted, so history stays walkable.
Engraphy is self-hosted. It stores what an agent learns as a typed knowledge graph on Postgres + pgvector: writes deduplicate themselves against existing memory, retrieval fuses semantic and lexical search, isolation between users is enforced by the database, and the whole shape of memory is declared per application as a pack.
It exists to replace the reference MCP memory server's flat-JSON, single-user, stdio model with something that survives concurrency, paraphrase, duplicates, and years of accumulated memory. It speaks the Model Context Protocol, so any MCP client (a VS Code extension, a desktop app, another agent) can use it over HTTP.
Source-available. Licensed under the Business Source License 1.1: read it,
run it, build on it, and use it in production for your own product. Offering
Engraphy itself as a hosted or managed service to third parties is reserved to
the Licensor until the Change Date, when it converts to Apache-2.0. See
License.
fact, decision, person, event, …) joined by typed edges (involves, references, supersedes, …). The types, their attribute schemas, and the rules for which edges may connect which types are declared per space in a pack and enforced in Postgres.search fuses a vector leg (cosine over embeddings) and a lexical leg (Postgres full-text) with Reciprocal Rank Fusion, and traverse walks the edges. Attribute values are folded into the searchable surface, so a fact stored only in a typed attribute is still findable.NOBYPASSRLS role.scope_guide tool returns that routing manifest so an agent can decide *where* a new memory belongs before it writes.flowchart LR
C[MCP client VS Code · desktop · agent] -->|HTTP + bearer token| S[Engraphy server FastMCP] S --> E[Embedding nomic-embed-text-v1.5] S --> DB[(Postgres 16 + pgvector nodes · edges · scopes RLS · schema enforcement)] P[Pack types · edges · briefing] -.declares.-> DB
A write is embedded, banded by similarity into merge / merge-link / pending / new, and committed under the caller's identity. A read (search, get, traverse, briefing) runs under RLS so a caller only ever sees the scopes they were granted. A pack declares the node types, edge types, attribute schemas, and session-start briefing for a space, so one engine serves many differently shaped memory applications. The architecture overview walks the full write and read paths.
Requirements: Docker (with Compose). The cloud profile brings up Postgres, runs migrations, provisions the app role, and starts the server in one command.
# 1. Configure secrets (never committed)
cp deploy/.env.example .env # then edit, or: printf 'POSTGRES_PASSWORD=%s\nENGRAPHY_APP_ROLE_PASSWORD=%s\n' \ "$(openssl rand -hex 16)" "$(openssl rand -hex 16)" > .env
docker compose up -d # the embedding model ships baked into the image
docker compose --profile admin run --rm admin \ engraphy-admin space create --id personal --display-name "My Memory" --principal me docker compose --profile admin run --rm admin \ engraphy-admin pack apply packs/starter/pack.yaml --space personal docker compose --profile admin run --rm admin \ engraphy-admin token create --space personal --principal me \ --client-name my-editor --role readwrite
The server is now on 127.0.0.1:8000 (put a TLS-terminating reverse proxy in front to expose it). Point any MCP client at it with the bearer token. The setup guide covers the local, no-Docker path as well.
up.sh and provision.sh (with up.ps1 / provision.ps1 as Windows equivalents) wrap exactly the sequence above, and add the waiting that a copy-paste quickstart cannot:
./up.sh # writes .env with random passwords, starts the stack,
./provision.sh # creates the space, applies the starter pack, mints a token,
up.sh polls /healthz rather than compose's health status, because on first boot compose reports starting for as long as the model cache takes to seed, which looks identical to a crash-loop from the outside. A 200 is the real signal.
Both scripts are safe to re-run: an existing .env is never overwritten, and an existing space or an already-applied pack is skipped rather than treated as an error, so a re-run still mints a fresh token.
Everything is parameterised, with defaults that work unchanged:
| default | override | |
|---|---|---|
| space id | default | ./provision.sh myspace or -Space myspace |
| principal | me | ./provision.sh myspace alice or -Principal alice |
| client name | my-client | third positional arg, or -ClientName |
| pack | /app/packs/starter/pack.yaml | ENGRAPHY_PACK or -Pack |
| host port | 8000 | ENGRAPHY_HOST_PORT in .env, or -Port |
| health timeout | 1800s up, 600s provision | ENGRAPHY_WAIT_SECS or -WaitSeconds |
The token is printed once and never written to disk by the scripts; the server stores only its SHA-256. If you lose it, re-run provision.sh for a new one.
Engraphy is an MCP server, so a client connects and calls tools:
| Tool | What it does |
|---|---|
write | Dedup-banded write; returns the node or a duplicate-check verdict plus a resonance report. |
search | Hybrid semantic + lexical retrieval across one scope or all. |
traverse | Recursive graph walk from a starting node. |
get | Full nodes plus edge summaries, by id. |
briefing | Pack-declared session-start sections (due commitments, relevant notes, …). |
scope_guide | The routing manifest: every writable scope and what it governs. |
scope_list / scope_create | List readable scopes / create a private one. |
link · update · supersede · resolve_duplicate | Edit the graph and settle pending verdicts. |
pending_list · stats · inbox_review | Inspect pending writes, usage metrics, and the capture inbox. |
admin_* | Space administration (members, tokens, grants, visibility). |
See the tool reference for parameters, returns, and an example per tool. A first-party VS Code extension lives in vscode-extension/.
pgvector/pgvector:pg16 image ships both).PATH for the no-Docker path).v0.1.0. The schema and enforcement kernel, engine behaviors (dedup, hybrid retrieval, graph traversal, briefings), the MCP server with auth and admin, and the operator CLI are implemented and covered by a live-Postgres test suite plus a CI job that exercises the shipped deploy artifacts end to end. A benchmark harness (bench/, design/09) runs the engine against public long-term-memory datasets; it is a tool for measuring changes, not a source of marketing numbers. bench/RUN-LOCOMO.md is the walkthrough for running LoCoMo yourself: it needs an OpenAI-compatible base URL and key, and it pins the dataset, the arm, the models and the judge.
Issues and pull requests are welcome. CONTRIBUTING.md covers getting a development database up, running the suite, what the three CI jobs check, and the house style. Security problems go through a private advisory rather than a public issue.
Engraphy is licensed under the Business Source License 1.1 (see LICENSE).
Copyright (c) 2026 Devon Clark.