Nucleus

El servidor MCP que hace que los resultados de la IA sean más fiables cada semana.

Los agentes de IA alucinan, rompen código y repiten errores. Nucleus detecta esto. Cada resultado de la IA se verifica, cada corrección se registra y cada error entrena al sistema para no repetirlo. Localmente, en tu máquina.

Tres fronteras

El bucle central que hace que la fiabilidad de la IA se multiplique con el tiempo:

  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 (Tierra) — Verificación de ejecución en 5 niveles. Sintaxis, importaciones, pruebas, tiempo de ejecución. Va más allá del sistema formal para comprobar el trabajo de la IA.

ALIGN (Alineación) — Correcciones de una sola llamada. nucleus_align(action="correct", params={context, correction}). Cada corrección registra automáticamente un veredicto, crea un par de entrenamiento y emite un evento.

COMPOUND (Compuesto) — Los deltas miden la brecha entre la intención y la realidad. Los patrones recurrentes se convierten en estrategia. Los deltas negativos se convierten en señal de entrenamiento.

Cada respuesta de la herramienta muestra el estado de la frontera:

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

Inicio rápido

pip install nucleus-mcp
nucleus init --recipe founder

Dos comandos. Nucleus está en marcha. Los resultados de la IA ahora están verificados.

Qué hace

114 herramientas MCP a través de 14 fachadas:

• GROUND — Verificación de ejecución (5 niveles: diff, sintaxis, importaciones, pruebas, tiempo de ejecución)

• ALIGN — Correcciones humanas (veredicto + delta + DPO + evento en una sola llamada)

• Memoria — Engramas que persisten entre sesiones. Escribe una vez, recuerda para siempre.

• Sesiones — Guarda el contexto, retoma más tarde. El arco de sesión muestra tus últimas 3 sesiones.

• Tareas — Cola de prioridad con escalada, puertas HITL (Human-in-the-loop) y monitoreo de latidos.

• Gobernanza — Interruptor de apagado, configuraciones de cumplimiento (EU DORA, MAS TRM, SOC2), pistas de auditoría.

• Orquestación — Ranuras de agente, sincronización de múltiples cerebros, despacho de tareas.

• Archivo — Canalización de entrenamiento (SFT + DPO), seguimiento de deltas, panel de salud de la frontera.

Nucleus Pro

Todo lo anterior es gratuito (MIT). Nucleus Pro añade gobernanza verificable:

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

$19/mes o $149/año — nucleusos.dev/pricing

Instalación

Un clic

pip / npx

pip install nucleus-mcp

O usa npx (no requiere configuración de Python):

npx -y nucleus-mcp

Configura tu cliente MCP

Claude Desktop / Cursor / Windsurf

Añádelo a tu configuración de MCP (claude_desktop_config.json o equivalente):

{
  "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

Añádelo a .mcp.json en la raíz de tu proyecto:

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

Descubrimiento de rutas

Nucleus encuentra tu .brain automáticamente:

1. Variable de entorno NUCLEAR_BRAIN_PATH (explícita)

2. Subir desde CWD buscando el directorio .brain/

3. Volver a $HOME/.nucleus/brain

CLI

Nucleus tiene una CLI completa junto con las herramientas MCP. Detecta automáticamente TTY (salida de tabla) frente a tubería (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

Compatible con tuberías:

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

Cumplimiento

Configuración de un solo comando para marcos regulatorios:

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

Telemetría

Nucleus recopila estadísticas de uso agregadas y anónimas (nombre del comando, duración, tipo de error, versiones, SO). Sin contenido de engramas, sin rutas de archivo, sin prompts, sin claves API, sin PII, nunca.

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

Consulta TELEMETRY.md para más detalles.

Contribución

• ¿Un error? Abre un Issue

• ¿Idea de función? Inicia una Discusión

• ¿Código? Consulta CONTRIBUTING.md

• ¿Chat? Discord

Licencia

MIT © 2026 | hello@nucleusos.dev