josedario87
7ee9e69b28
- Cambiar router MCP para usar APP_DOMAIN/mcp en lugar de dominio separado - Prioridad 200 para que tenga precedencia sobre otros routers - Eliminar variable MCP_DOMAIN del workflow y .env.example - Actualizar README con nueva configuración de endpoints - El servidor MCP estará en docs.nucleoriofrio.com/mcp sin Authentik
66 lines
2.0 KiB
Markdown
66 lines
2.0 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|