Files
nucleoDocs/README.md
josedario87 aa5ac70c7c
All checks were successful
build-and-deploy / build (push) Successful in 8s
build-and-deploy / deploy (push) Successful in 10s
Agregar servidor MCP Docker al stack
- Agregado servicio mcp-docker con imagen docker:cli
- Configurado MCP Gateway en modo streaming (puerto 8080)
- Expuesto a través de Traefik sin autenticación Authentik
- Montado socket de Docker en modo solo lectura
- Agregada variable MCP_DOMAIN al .env.example
- Actualizado README con documentación del servicio
2025-10-13 18:48:02 -06:00

1.8 KiB

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 oficial de Docker (docker:cli) que permite gestionar contenedores Docker mediante lenguaje natural. Este servicio:

  • Usa el MCP Gateway en modo streaming (puerto 8080)
  • Tiene acceso al socket de Docker del host (solo lectura)
  • Se ejecuta en las redes principal y traefik-network
  • Expuesto públicamente a través de Traefik SIN autenticación Authentik
  • Accesible en el dominio configurado en MCP_DOMAIN
  • Incluye soporte para WebSocket y streaming

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