Eve MCP-Client

eve-client ist der lokale Installer und die Integrations-CLI, um unterstützte KI-Tools mit dem gehosteten Eve-Speicherdienst zu verbinden.

Er erkennt lokale Tools, konfiguriert MCP, installiert Eve-verwaltete Prompt- und Hook-Dateien, wo dies unterstützt wird, verwaltet die Authentifizierung und kann die Integration später verifizieren, reparieren oder entfernen. Er kann auch lokale Verläufe von unterstützten Clients importieren.

Wie Eve funktioniert

Wenn Sie eve install ausführen, konfiguriert Eve vier Lebenszyklus-Hooks, die automatisch ausgeführt werden — während Ihrer Sitzungen sind keine Befehle erforderlich.

Lebenszyklus-Hooks sind für Claude Code und Gemini CLI verfügbar. Eve verbindet sich auch mit Codex CLI und anderen MCP-kompatiblen Clients mittels Prompt-Seeding, sodass Sie speicherübergreifend über alle Ihre Tools hinweg arbeiten können.

Related MCP server: Sovereign Universal Memory MCP

Schnellstart — 5 Minuten

1. Holen Sie sich einen Eve-Arbeitsbereich

Beantragen Sie den Zugriff unter evemem.com. Melden Sie sich nach der Bereitstellung an und erstellen Sie einen API-Schlüssel unter evemem.com/app/overview.

2. Installieren Sie den Client

uv tool install git+https://github.com/sherifkozman/eve-mcp.git

Kein uv? Verwenden Sie:

pipx install git+https://github.com/sherifkozman/eve-mcp.git

Überprüfen: eve version

3. Verbinden Sie Claude Code (tauschen Sie --tool gemini-cli für Gemini CLI aus)

eve connect --tool claude-code --api-key <your-eve-api-key>

Dies kombiniert Authentifizierung, Installation und Überprüfung. Für eine Schritt-für-Schritt-Anleitung siehe API-Schlüssel-Ablauf unten.

Erwartete Ausgabe:

✓ MCP config written
✓ CLAUDE.md companion updated
✓ Lifecycle hooks configured — Eve auto-injects memory context on every session
✓ Eve memory is connected and responding

Was ist gerade passiert? Eve hat vier Lebenszyklus-Hooks installiert. Von diesem Moment an beginnt jede Claude Code-Sitzung mit Ihrem vorab geladenen Speicherkontext und endet mit der Erfassung neuer Erkenntnisse. Sie müssen Claude niemals bitten, Eve zu verwenden.

Falls eve connect fehlschlägt: Führen Sie eve doctor --tool claude-code aus und überprüfen Sie die Diagnoseausgabe. Eröffnen Sie ein Issue unter github.com/sherifkozman/eve-mcp.

4. Testen Sie den Speicher über Sitzungen hinweg

Sagen Sie Claude in Claude Code:

"Merke dir, dass ich PostgreSQL mit einer users-Tabelle verwende — email- und created_at-Spalten."

Starten Sie eine neue Claude Code-Sitzung und fragen Sie:

"Welches Datenbank-Setup habe ich erwähnt?"

Claude wird sich über Eve daran erinnern. ✓

Siehe examples/ für manuelle MCP-Konfigurationsschnipsel (kein Installer erforderlich).

Installation

Bevor Sie den Client installieren, besorgen Sie sich einen Eve-Arbeitsbereich:

• Zugriff anfordern: https://evemem.com

• Melden Sie sich nach der Bereitstellung Ihres Arbeitsbereichs beim Eve-Dashboard an:

  • https://evemem.com/app/overview

• Wenn Sie die API-Schlüssel-Authentifizierung verwenden möchten, erstellen oder rotieren Sie einen Mandantenschlüssel über den Eve-Admin/Benutzer-Einrichtungsprozess, bevor Sie Ihren Client verbinden.

Von GitHub jetzt

Bevorzugt:

uv tool install git+https://github.com/sherifkozman/eve-mcp.git

Alternative:

pipx install git+https://github.com/sherifkozman/eve-mcp.git

Oder über den eigenständigen Bash-Installer:

curl -fsSL https://raw.githubusercontent.com/sherifkozman/eve-mcp/main/install.sh | bash

Dann bestätigen:

eve version
eve --help

Manuelle Konfiguration (kein Installer)

Siehe examples/ für fertige MCP-Konfigurationsschnipsel zum Einfügen für Claude Code, Gemini CLI und Codex CLI.

Von PyPI später

Sobald veröffentlicht, wird die Paketinstallation wie folgt lauten:

uv tool install eve-client

oder:

pipx install eve-client

Was der Eve-Client tut

• erkennt unterstützte lokale KI-Clients

• zeigt einen Installationsplan an, bevor Dateien geändert werden

• schreibt Eve-verwaltete MCP-Konfiguration

• installiert Prompt-/Begleitdateien, wo unterstützt

• installiert vier Lebenszyklus-Hooks, die bei jeder Sitzung automatisch den Speicherkontext injizieren (SessionStart, UserPromptSubmit, PreCompact, Stop)

• speichert Authentifizierungsdaten lokal mithilfe einer dateibasierten Anmeldeinformationsspeicherung

• bietet eve memory search und eve memory status Befehle für den direkten Speicherzugriff

• verifiziert, repariert, setzt zurück und deinstalliert Eve-verwaltete Änderungen

• importiert lokale Konversationsverläufe von unterstützten Clients in Eve

Importieren lokaler Verläufe

Unterstützte Importquellen heute:

• Claude Code

• Codex CLI

• Gemini CLI

Kernbefehle:

eve import scan --source claude-code
eve import preview --source claude-code --path <session_file>
eve import jobs                              # list scan jobs
eve auth login --tool claude-code
eve import upload --job <scan_job_id> --use-auth-from claude-code
eve import runs                              # list upload runs
eve import resume --run <run_id>
eve import cleanup --days 30
eve import cleanup --days 30 --apply

Wie es funktioniert:

• analysiert den lokalen Verlauf auf Ihrem Computer

• lädt normalisierte Batches in den verwalteten Eve-Dienst hoch

• führt ein lokales SQLite-Ledger für Scan-Jobs, Upload-Läufe, Wiedergabe und Fortsetzung

• unterstützt standardmäßig die Bereinigung alter, abgeschlossener lokaler Importläufe (Dry-Run)

Import-Wartung:

• eve import cleanup ist ein allgemeiner Befehl zur Wartung des lokalen Ledgers, kein client-spezifisches Importquellen-Feature

Hinweis zur Authentifizierung:

• vermeiden Sie es, Geheimnisse nach Möglichkeit direkt in der Befehlszeile zu übergeben

• bevorzugen Sie zuerst eve auth login ..., führen Sie dann Importbefehle aus, ohne den API-Schlüssel zu wiederholen

• in einer interaktiven Shell fragt eve auth login --tool claude-code sicher nach dem Schlüssel

Aktueller Rollout-Hinweis:

• Korrektheit und Fortsetzung sind solide

• sehr große Importe, insbesondere Claude-lastige, können noch langsamer als ideal sein, während die Batch-Standardwerte weiter optimiert werden

Unterstützte Clients

Claude Code

Unterstützt heute:

• MCP-Konfiguration

• CLAUDE.md Begleitdatei

• paketverwaltete Hooks

• Import-Unterstützung: scan, preview, upload, resume

Primärer Authentifizierungspfad heute:

• Eve API-Schlüssel

Gemini CLI

Unterstützt heute:

• MCP-Konfiguration

• GEMINI.md Begleitdatei

• paketverwaltete Hooks

• Import-Unterstützung: scan, preview, upload, resume

Primärer Authentifizierungspfad heute:

• Eve API-Schlüssel

Codex CLI

Unterstützt heute:

• MCP-Konfiguration

• Eve-eigener OAuth-Login

• Laufzeit-Bearer-Token-Injektion

• Import-Unterstützung: scan, preview, upload, resume

Primärer Authentifizierungspfad heute:

• Eve OAuth

Wichtig:

• nativer Codex MCP-Login ist nicht der unterstützte Eve-Pfad

Claude Desktop

Nicht lokal für gehostetes Eve vorkonfiguriert.

Authentifizierungsanforderungen

Sie benötigen einen Eve-Arbeitsbereich und entweder:

• einen Eve API-Schlüssel, oder

• Eve OAuth-Zugriff für unterstützte Abläufe

Aktuelle Authentifizierungserwartungen:

• Claude Code: API-Schlüssel

• Gemini CLI: API-Schlüssel

• Codex CLI: Eve OAuth

Der OAuth-Browser-Ablauf existiert für weitere Clients, ist aber außerhalb des Codex-Pfades noch experimentell und sollte noch nicht als standardmäßiger Produktions-Installer-Ablauf behandelt werden.

Grundlegende Verwendung

Erster Lauf

eve quickstart
eve connect --tool claude-code
eve verify --tool claude-code

API-Schlüssel-Ablauf

eve auth login --tool claude-code --api-key <eve-key>
eve install --tool claude-code --apply --yes  # --apply writes config, --yes skips confirmation
eve verify --tool claude-code

Codex OAuth-Ablauf

eve auth login --tool codex-cli --auth-mode oauth
eve install --tool codex-cli --auth-mode oauth --apply --yes
eve verify --tool codex-cli --auth-mode oauth

Speicherbefehle

eve memory search "what database do we use" --context naya
eve memory search "auth patterns" --limit 5 --json
eve memory status
eve memory status --json

Häufige Befehle

eve quickstart
eve connect
eve install --dry-run
eve install --apply --yes --tool claude-code
eve status
eve doctor
eve verify
eve repair --tool gemini-cli --apply --yes
eve uninstall --tool claude-code --yes
eve run --tool codex-cli -- exec "Use Eve memory to search for my latest preference."

Manuelle MCP-Konfiguration

Wenn Sie nicht möchten, dass der Installer die Client-Konfiguration für Sie bearbeitet, fügen Sie den gehosteten Eve MCP-Server manuell hinzu.

Gemeinsamer gehosteter MCP-Endpunkt

https://mcp.evemem.com/mcp

Claude Code / Gemini CLI (API-Schlüssel)

Verwenden Sie einen Mandanten-API-Schlüssel aus dem Eve-Admin-Panel.

{
  "eve-memory": {
    "type": "http",
    "url": "https://mcp.evemem.com/mcp",
    "headers": {
      "X-API-Key": "eve_<tenant>_...",
      "X-Source-Agent": "claude_code"
    }
  }
}

Behalten Sie für Gemini die gleiche Form bei und ändern Sie:

X-Source-Agent = gemini_cli

Codex CLI (OAuth)

Codex sollte ein Eve-eigenes Bearer-Token verwenden, nicht den nativen codex mcp login.

[mcp_servers.eve-memory]
url = "https://mcp.evemem.com/mcp"
bearer_token_env_var = "EVE_CODEX_BEARER_TOKEN"
startup_timeout_sec = 60

[mcp_servers.eve-memory.headers]
X-Source-Agent = "codex_cli"

OAuth-Ressource:

https://mcp.evemem.com/mcp

Codex Prompt-Seeding gehört in die aktive Projektdatei AGENTS.md. Eve verwaltet seinen eigenen markierten Block innerhalb dieser Datei, anstatt eine parallele Sidecar-Datei zu erstellen.

Andere MCP-Clients

Für andere Remote-MCP-Clients ist die minimale funktionierende Einrichtung:

1. MCP-URL:

https://mcp.evemem.com/mcp

2. Ein Source-Agent-Header:

X-Source-Agent: your_client_name

3. Wählen Sie einen Authentifizierungsstil:

• API-Schlüssel:

X-API-Key: eve_<tenant>_...

• OAuth-Bearer:

Authorization: Bearer <token>

4. Verwenden Sie für OAuth-fähige Clients diesen Ressourcenbezeichner:

https://mcp.evemem.com/mcp

5. Erforderliche Scopes:

memory.read
memory.write

Wenn der Client eine Begleit-Anweisungsdatei unterstützt, verweisen Sie auf die aktive Anweisungsdatei für dieses Tool, anstatt eine zweite parallele Datei zu erfinden.

Welchen Authentifizierungspfad verwenden

• Claude Code: API-Schlüssel

• Gemini CLI: API-Schlüssel

• Codex CLI: Eve OAuth

Wenn Sie möchten, dass Eve die Konfiguration, Prompts, Hooks und Verifizierung für Sie verwaltet, verwenden Sie eve connect, anstatt Dateien manuell zu bearbeiten.

Sicherheitsmodell

• keine stille Shell-Profil-Mutation

• keine undokumentierten Hooks

• kein Überschreiben von benutzerdefinierten Anweisungsdateien

• Backup und Manifest-Tracking vor der Mutation

• explizite Unterstützung für Rollback und Deinstallation

• Deinstallation entfernt Eve-verwaltete Anmeldeinformationen und Tool-Einträge und warnt, wenn eine vom Benutzer geänderte, Eve-eigene Datei eine manuelle Überprüfung erfordert

Entwicklung

Tests ausführen:

uv run pytest --cov=eve_client --cov-report=term-missing -q tests

Python-Artefakte erstellen:

uv build .

Build-Artefakte überprüfen:

uvx twine check dist/*

Eigenständige Release-Artefakte erstellen:

bash scripts/build-eve-client-release.sh

Lizenz

Apache-2.0. Siehe LICENSE.