Firmament Open Brain

Ein gemeinsames „Kontext-Gehirn“ für das Firmament-Team, inspiriert von OB1, aber für Railway schlank neu aufgebaut. Es ist ein MCP-Server (Model Context Protocol) mit Postgres als Backend: Jede Person erhält einen privaten Erinnerungsspeicher, der ihr über KI-Tools hinweg folgt (Claude Desktop, Claude Code, claude.ai, Cursor usw.). Erinnerungen sind pro Benutzer isoliert – dein Token sieht nur deine eigenen Erinnerungen.

So funktioniert es

• Ein Railway-Service (diese Node-App) + eine Railway-Postgres-Datenbank.

• Jede Person erhält ein persönliches Token. Ihre MCP-URL ist https://<host>/mcp/<token>.

• Alle Lese- und Schreibzugriffe auf Erinnerungen sind auf den Benutzer begrenzt, auf den das Token aufgelöst wird. Tokens werden gehasht (SHA-256) gespeichert.

• Die Suche nutzt die Postgres-Volltextsuche mit einem Substring-Fallback – es werden keine Embedding-API-Schlüssel benötigt.

Related MCP server: LedgerMem MCP Server

Verfügbare MCP-Tools

Client verbinden

Claude Code:

claude mcp add --transport http openbrain https://<host>/mcp/<your-token>

Claude Desktop / claude.ai: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → https://<host>/mcp/<your-token> einfügen.

Cursor: Einstellungen → MCP → Server hinzufügen, Typ http, dieselbe URL.

Danach einfach sagen: „merke dir ...“ / „was weißt du über ...“. Eine gute Gewohnheit ist, Sitzungen mit „durchsuche mein Open Brain nach Kontext zu “ zu beginnen.

Admin (Benutzer erstellen)

Erfordert die Umgebungsvariable ADMIN_TOKEN; übergib sie als Bearer-Token.

# create a user (returns their token + MCP URL — shown only once)
curl -X POST https://<host>/admin/users \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Jack Wright"}'

# list users
curl https://<host>/admin/users -H "Authorization: Bearer $ADMIN_TOKEN"

# delete a user (and all their memories)
curl -X DELETE https://<host>/admin/users/<id> -H "Authorization: Bearer $ADMIN_TOKEN"

Bereitstellen (Railway)

Umgebungsvariablen im App-Service:

• DATABASE_URL — Verweis auf die Railway-Postgres-Datenbank

• ADMIN_TOKEN — lange zufällige Zeichenkette (Admin-API-Authentifizierung)

• DATABASE_SSL — auf false setzen, wenn du dich über das private Railway-Netzwerk verbindest

Mit railway up aus diesem Verzeichnis bereitstellen. Das Schema wird beim Start automatisch erstellt.

Sicherheitshinweise

• Das Token steckt in der URL. Genau das macht die Verbindung so einfach wie ein einziges Einfügen, und für ein kleines, vertrauenswürdiges Team ist das in Ordnung. Behandle die URL aber wie ein Passwort: Teile sie nicht und füge sie nicht in Gruppenchats ein.

• Verlorenes Token → Benutzer löschen und ein neues erstellen (Erinnerungen sind an die Benutzerzeile gebunden, daher löscht das Löschen des Benutzers auch seine Erinnerungen – bei Bedarf vorher exportieren).