Personal Brain MCP v0.2

Ein PostgreSQL-gestützter langfristiger persönlicher Gedächtnis-MCP-Server. Er unterstützt lokales Docker PostgreSQL und entferntes Neon PostgreSQL und stellt einen Streamable HTTP MCP-Endpunkt für das Hosting auf Render bereit.

MCP-Tools

• get_personal_context

• save_memory

• query_personal_database – nur vom Modell generiertes, schreibgeschütztes SQL

• update_context_manifest

Related MCP server: hippocampus-mcp

Remote-Endpunkte

• MCP: POST /mcp (Streamable HTTP)

• Health-Check: GET /health

Lokale Entwicklung mit Docker PostgreSQL

cp .env.example .env
# Remove/comment DATABASE_URL in .env to use the local Docker settings.
docker compose up -d
npm install
npm run check
npm run dev

Der Server hört standardmäßig auf http://localhost:10000.

Neon / Render

Setzen Sie diese Umgebungsvariablen in Render:

DATABASE_URL=<Neon connection string>
MCP_API_KEY=<long random secret, recommended>
USER_ID=main
USER_NAME=<your display name>
USER_LANGUAGE=ko
USER_TIMEZONE=Asia/Seoul

Render stellt PORT automatisch bereit. Die Anwendung bindet an 0.0.0.0:$PORT.

Build-Befehl:

npm install && npm run build

Startbefehl:

npm start

Health-Check-Pfad:

/health

Nach der Bereitstellung lautet der MCP-Endpunkt:

https://<your-render-service>.onrender.com/mcp

Wenn MCP_API_KEY gesetzt ist, müssen Clients senden:

Authorization: Bearer <MCP_API_KEY>

Datenbankinitialisierung

Beim Start erstellt die Anwendung sicher die erforderlichen Tabellen und Indizes, falls diese noch nicht existieren. pgvector ist in v0.2 optional; ein Fehler bei der Aktivierung verhindert nicht den Start.

Sicherheit

• .env wird von Git ignoriert.

• Committen Sie niemals Neon-Verbindungsstrings, Passwörter, API-Schlüssel oder Tokens.

• query_personal_database akzeptiert nur eine einzelne SELECT/WITH-Abfrage, führt sie in einer schreibgeschützten Transaktion aus und begrenzt die Ausgabe auf 100 Zeilen.