Nucleus

Der MCP-Server, der KI-Ergebnisse jede Woche zuverlässiger macht.

KI-Agenten halluzinieren, zerstören Code und wiederholen Fehler. Nucleus erkennt dies. Jedes KI-Ergebnis wird überprüft, jede Korrektur aufgezeichnet und jeder Fehler trainiert das System, ihn nicht zu wiederholen. Lokal, auf Ihrem Rechner.

Drei Fronten

Der Kernkreislauf, der die KI-Zuverlässigkeit mit der Zeit steigert:

  GROUND              ALIGN               COMPOUND
  ──────              ─────               ────────
  Machine verifies    Human corrects      System learns

  AI writes code  →  You fix a mistake →  Delta recorded
  GROUND checks   →  Verdict stored    →  DPO pair created
  Receipt logged  →  Event emitted     →  Training data grows
       │                   │                    │
       └───────────────────┴────────────────────┘
                    Reliability improves

GROUND — 5-stufige Ausführungsüberprüfung. Syntax, Importe, Tests, Laufzeit. Geht über das formale System hinaus, um die Arbeit der KI zu prüfen.

ALIGN — Korrekturen mit einem Aufruf. nucleus_align(action="correct", params={context, correction}). Jede Korrektur zeichnet automatisch ein Urteil auf, erstellt ein Trainingspaar und sendet ein Ereignis.

COMPOUND — Deltas messen die Lücke zwischen Absicht und Realität. Wiederkehrende Muster werden zur Strategie. Negative Deltas werden zum Trainingssignal.

Jede Tool-Antwort zeigt den Status der Fronten:

[frontiers: GROUND 42 | ALIGN 12 | COMPOUND 28]

Schnellstart

pip install nucleus-mcp
nucleus init --recipe founder

Zwei Befehle. Nucleus läuft. KI-Ergebnisse sind nun überprüft.

Was es tut

114 MCP-Tools über 14 Fassaden:

• GROUND — Ausführungsüberprüfung (5 Stufen: Diff, Syntax, Importe, Tests, Laufzeit)

• ALIGN — Menschliche Korrekturen (Urteil + Delta + DPO + Ereignis in einem Aufruf)

• Memory — Engramme, die sitzungsübergreifend bestehen bleiben. Einmal schreiben, für immer abrufen.

• Sessions — Kontext speichern, später fortsetzen. Der Sitzungsbogen zeigt Ihre letzten 3 Sitzungen.

• Tasks — Prioritätswarteschlange mit Eskalation, HITL-Gates und Heartbeat-Überwachung.

• Governance — Kill-Switch, Compliance-Konfigurationen (EU DORA, MAS TRM, SOC2), Audit-Trails.

• Orchestration — Agenten-Slots, Multi-Brain-Synchronisation, Aufgabenverteilung.

• Archive — Trainings-Pipeline (SFT + DPO), Delta-Tracking, Dashboard für den Fronten-Status.

Nucleus Pro

Alles oben Genannte ist kostenlos (MIT). Nucleus Pro fügt überprüfbare Governance hinzu:

nucleus trial                              # 14-day free trial
nucleus compliance-check                   # Score your AI governance
nucleus audit-report --signed -o report.html  # Cryptographically signed report

$19/Monat oder $149/Jahr — nucleusos.dev/pricing

Installation

Mit einem Klick

pip / npx

pip install nucleus-mcp

Oder verwenden Sie npx (kein Python-Setup erforderlich):

npx -y nucleus-mcp

Konfigurieren Sie Ihren MCP-Client

Claude Desktop / Cursor / Windsurf

Fügen Sie dies zu Ihrer MCP-Konfiguration hinzu (claude_desktop_config.json oder äquivalent):

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp"]
    }
  }
}

{
  "mcpServers": {
    "nucleus": {
      "command": "python3",
      "args": ["-m", "mcp_server_nucleus"],
      "env": {
        "NUCLEAR_BRAIN_PATH": "/path/to/your/project/.brain"
      }
    }
  }
}

Claude Code

Fügen Sie dies zu .mcp.json in Ihrem Projektstammverzeichnis hinzu:

{
  "mcpServers": {
    "nucleus": {
      "command": "npx",
      "args": ["-y", "nucleus-mcp"]
    }
  }
}

Pfad-Erkennung

Nucleus findet Ihr .brain automatisch:

1. NUCLEAR_BRAIN_PATH Umgebungsvariable (explizit)

2. Suche vom aktuellen Arbeitsverzeichnis (CWD) aufwärts nach dem .brain/ Verzeichnis

3. Fallback auf $HOME/.nucleus/brain

CLI

Nucleus verfügt neben den MCP-Tools über eine vollständige CLI. Erkennt automatisch TTY (Tabellenausgabe) vs. Pipe (JSON).

# Memory
nucleus engram write my_key "insight here" --context Decision --intensity 7
nucleus engram search "compliance"
nucleus engram query --context Strategy --limit 10

# Tasks
nucleus task list --status READY
nucleus task add "Ship the feature" --priority 1

# Sessions
nucleus session save "Working on auth refactor"
nucleus session resume

# Health
nucleus status --health
nucleus sovereign

# Compliance
nucleus comply --jurisdiction eu-dora
nucleus audit-report --format html -o report.html

# Chat (multi-provider: Gemini, Anthropic, Groq)
nucleus chat

Pipe-freundlich:

nucleus engram search "test" | jq '.key'
nucleus task list --format tsv | cut -f1,3

Compliance

Konfiguration mit einem Befehl für regulatorische Rahmenbedingungen:

nucleus comply --jurisdiction eu-dora       # EU DORA
nucleus comply --jurisdiction sg-mas-trm    # Singapore MAS TRM
nucleus comply --jurisdiction us-soc2       # US SOC2

Telemetrie

Nucleus sammelt anonyme, aggregierte Nutzungsstatistiken (Befehlsname, Dauer, Fehlertyp, Versionen, Betriebssystem). Keine Engramm-Inhalte, keine Dateipfade, keine Prompts, keine API-Schlüssel, keine personenbezogenen Daten (PII) — niemals.

nucleus config --no-telemetry
# or: NUCLEUS_ANON_TELEMETRY=false

Siehe TELEMETRY.md für Details.

Mitwirken

• Fehler? Öffnen Sie ein Issue

• Feature-Idee? Starten Sie eine Diskussion

• Code? Siehe CONTRIBUTING.md

• Chat? Discord

Lizenz

MIT © 2026 | hello@nucleusos.dev