Nucleo Docs

Sistema de documentación para el ecosistema Nucleo basado en Nuxt 4 con autenticación mediante Authentik Proxy Outpost.

Propósito

Este repositorio contiene la documentación del funcionamiento del sistema Nucleo, incluyendo:

• Arquitectura del sistema
• Guías de desarrollo
• Documentación de servicios
• Procedimientos operativos

Estructura del Proyecto

.
├── nuxt4/              # Aplicación Nuxt 4 con la documentación
├── docker-compose.yml  # Configuración de despliegue
└── .gitea/            # Gitea Actions CI/CD

Características

• ✅ Nuxt 4
• ✅ Autenticación con Authentik Proxy Outpost
• ✅ Docker y Docker Compose
• ✅ CI/CD con Gitea Actions
• ✅ Traefik para proxy reverso y SSL
• ✅ Claude Code hooks para monitoreo de Actions
• ✅ MCP Server Docker para gestión de contenedores

Servicios

Aplicación Principal (app)

Aplicación Nuxt 4 con la documentación del sistema Nucleo, expuesta mediante Traefik con autenticación Authentik.

MCP Docker Server (mcp-docker)

Servidor MCP personalizado construido con TypeScript que expone operaciones Docker a través del protocolo MCP sobre HTTP. Este servicio:

• Implementa 13 herramientas Docker seguras usando dockerode
• Usa el puerto 3000 para comunicación HTTP
• Tiene acceso al socket de Docker del host (solo lectura)
• Se ejecuta en las redes principal y traefik-network
• Expuesto públicamente en APP_DOMAIN/mcp SIN autenticación Authentik
• Prioridad 200 en Traefik para evitar conflictos con otros routers
• Endpoints disponibles:
  • POST /mcp - Protocolo MCP para operaciones Docker
  • GET /mcp/health - Health check del servicio

Desarrollo Local

cd nuxt4
npm install
npm run dev

Despliegue

El proyecto se despliega automáticamente en docs.nucleoriofrio.com mediante Gitea Actions cuando se hace push a la rama master.

Variables y secrets configurados correctamente en Gitea.

Licencia

MIT