bejranonda/ExternalBrain

Was macht ExternalBrain?

Persistenter Speicher für KI-Codierungsagenten – selbsthostbarer MCP-Server + Web-App, die Claude Code / Cursor / Windsurf-Sitzungen in wiederverwendbare Fähigkeiten mit semantischer Suche und einem zitierten Oracle verwandelt. Einzel-VM Docker Compose, anbieterunabhängig (Gemini/GLM/OpenAI/Claude), MIT.

Funktionen

• Persistentes Gedächtnis – Speichert Sitzungsprotokolle, generierte Skills und Code-Kontext.
• Semantische Suche – Findet relevante Informationen basierend auf Ähnlichkeit, nicht nur auf Schlüsselwörtern.
• Oracle-Mechanismus – Liefert zitierte, vertrauenswürdige Antworten basierend auf gespeichertem Wissen.
• MCP-Server – Nahtlose Integration mit Claude Code, Cursor und Windsurf über das Model Context Protocol.
• Web-App – Verwaltung und Suche im gespeicherten Wissen über eine benutzerfreundliche Oberfläche.
• Anbieterunabhängig – Unterstützt OpenAI, Anthropic (Claude), Google (Gemini) und GLM.
• Selbsthostbar – Einfache Bereitstellung über Docker Compose auf einer einzelnen VM.

Schnellstart

1. Klone das Repository:

   git clone https://github.com/bejranonda/ExternalBrain.git
   cd ExternalBrain
   

2. Konfiguriere die Umgebungsvariablen in einer .env-Datei:

   DB_PATH=/data
   EMBEDDING_MODEL=text-embedding-3-small
   PROVIDER=openai
   OPENAI_API_KEY=sk-...
   

3. Starte den Dienst mit Docker Compose:

   docker compose up -d
   

4. Konfiguriere deinen KI-Codierungsagenten für die Verbindung zum MCP-Server (Standard: localhost:3000).

Integration

Claude Code

Füge die folgende Konfiguration zu deiner claude.json hinzu:

{
  "mcpServers": {
    "external-brain": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@bejranonda/external-brain-mcp"]
    }
  }
}

Cursor

Konfiguriere unter Einstellungen > MCP-Server:

• Name: ExternalBrain
• Typ: URL
• URL: http://localhost:3000/mcp

Windsurf

Verwende die Windsurf CLI zur Integration:

windsurf mcp add --name ExternalBrain --url http://localhost:3000/mcp

Verwendung

Sobald die Verbindung hergestellt ist, kann dein KI-Agent ExternalBrain automatisch nutzen:

• Speichern: Der Agent speichert automatisch Sitzungsprotokolle, generierte Skills und wichtige Erkenntnisse.
• Abrufen: Bei neuen Sitzungen ruft der Agent relevantes Wissen basierend auf dem aktuellen Kontext ab.
• Oracle: Stelle explizite Abfragen, um zitierte Antworten aus dem gespeicherten Wissen zu erhalten.
• Verwalten: Verwende die Web-App unter http://localhost:8080, um gespeichertes Wissen zu durchsuchen und zu verwalten.

Konfiguration

Variable	Beschreibung	Standard
DB_PATH	Pfad zur persistierten Datenbank	/data
EMBEDDING_MODEL	Einbettungsmodell, das verwendet werden soll	text-embedding-3-small
PROVIDER	KI-Anbieter (openai, anthropic, google, glm)	openai
OPENAI_API_KEY	API-Schlüssel für OpenAI	-
ANTHROPIC_API_KEY	API-Schlüssel für Anthropic	-
GOOGLE_API_KEY	API-Schlüssel für Google Gemini	-
GLM_API_KEY	API-Schlüssel für GLM	-

Lizenz

MIT