josedario87
a84c7b9114
- Creado servidor MCP en TypeScript con @modelcontextprotocol/sdk - Implementadas 13 herramientas Docker seguras usando dockerode: * docker_ps: Listar contenedores * docker_logs: Ver logs de contenedores * docker_inspect: Inspeccionar contenedor * docker_stats: Estadísticas de recursos * docker_top: Procesos del contenedor * docker_start/stop/restart: Gestión de contenedores * docker_exec: Ejecutar comandos * docker_images/networks/volumes: Listar recursos * docker_info: Información del sistema - Configurado servidor HTTP con Express en puerto 3000 - Agregado endpoint /mcp para protocolo MCP - Agregado health check en /health - Actualizado docker-compose.yml para usar imagen personalizada - Configurado GitHub Actions para build y deploy automático - Socket Docker montado en modo solo lectura para seguridad
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
principalytraefik-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