Essential View Builder MCP: Crea dashboards de Arquitectura Empresarial con IA

Objetivo

Crear vistas personalizadas en Essential Viewer usando lenguaje natural y el servidor MCP de Essential View Builder, sin necesidad de desarrollar manualmente.

Cuándo usar esto

Cuando necesitas una visualización personalizada de Essential Cloud que no existe en las vistas estándar del producto — por ejemplo, un dashboard para el CIO, un mapa de capacidades con ciclos de vida, o un timeline de planes estratégicos — y quieres generarla rápidamente desde lenguaje natural.

Pre-requisitos

• Docker instalado en tu máquina (método recomendado) — o Python 3.11+ como alternativa
• Acceso a un cliente de IA compatible: Claude Desktop, Cursor, VS Code, ChatGPT Desktop
• Acceso a tu instancia de Essential Cloud u Open Source con permisos de administración de vistas
• Imagen Docker construida localmente.

Inputs necesarios

• Descripción en lenguaje natural de la vista que deseas crear (audiencia, datos, tipo de gráfico, colores, etc.)
• Conocimiento alto nivel de las entidades principales de Essential contienen los datos relevantes (Aplicaciones, Capacidades, Proyectos, Tecnología, Seguridad)
• Opcionalmente: un prototipo HTML/JS estático si prefieres diseñar la vista visualmente primero

Paso a paso

Paso 1 — Construir la imagen Docker

Clona el repositorio y construye la imagen localmente:

docker build -t eas/essential-view-builder-mcp:v1 .

Verifica que el build esté correcto:

docker run -d --name essential-view-builder-mcp eas/essential-view-builder-mcp:v1
docker logs essential-view-builder-mcp
docker stop essential-view-builder-mcp && docker rm essential-view-builder-mcp

Paso 2 — Conectar el MCP a tu cliente de IA

Agrega la configuración correspondiente a tu cliente. El comando base es el mismo para todos:

docker run -i --rm --name essential-view-builder-mcp eas/essential-view-builder-mcp:v1

VS Code (mcp.json):

"essential-view-builder": {
			"type": "stdio",
			"command": "docker",
			"args": [
				"run",
				"-i",
				"--rm",
				"--name",
				"essential-view-builder-mcp",
				"eas/essential-view-builder-mcp:v1"
			]
		},

Paso 3 — Describir la vista al modelo

Usa uno de los tres métodos disponibles:

Método 1 — Lenguaje natural directo. Este método utilizamos para un cliente real y es la imagen que se observa arriba, generada después de 2 iteraciones mas.

Create an interactive dashboard for the CISO to monitor the overall security profile status of all applications within our organization. The dashboard should display the CIA assessment results for each application, indicate the implemented control measures, and when was the last time the application was reviewed. Create all the user facing labels in spanish

Método 2 — Prototipo HTML/JS existente: Diseña una versión estática con datos ficticios y luego indica al modelo:

Make this work with Essential Data

Método 3 — Estructura JSON como intermediario:

1. Create me a JSON structure from the Essential data APIs to allow me to see applications with lifecycles mapped to business capabilities

2. Use this JSON structure to create an application by capability view with counts by lifecycle status.

Paso 4 — Subir el archivo generado a Essential

Essential Cloud / Docker:

• Ve a Configure → System Administration → View Management
• Sube el archivo a la carpeta user/

Essential Open Source:

• Copia el archivo directamente a tu carpeta user/

Para probar sin crear una instancia de reporte:

[TU URL]/reportXML.xml&XSL=user/[NOMBRE_DEL_ARCHIVO]

Paso 5 — Publicar la vista como reporte

Una vez validada la vista en el paso anterior:

1. Crea una instancia de reporte en el repositorio. Esto permitirá incluirla como una vista en tu portal.
2. Establece el path como user/[NOMBRE_DEL_ARCHIVO]
3. Toma un screenshot, guárdalo como .png o .jpg y ponlo en la carpeta de imágenes
4. Apunta el image path a esa carpeta

Decisiones de diseño recomendadas

Elige el método de generación según el caso:

Para obtener mejores resultados, especifica siempre la audiencia objetivo en el prompt (CIO, CISO, Arquitecto EA) para que el modelo ajuste la densidad y el tipo de visualización.

Recomendación final

El Essential View Builder MCP elimina la dependencia técnica para crear nuevas vistas personalizadas en Essential Cloud. Cualquier consultor o arquitecto puede generar dashboards ejecutivos en minutos describiendo en lenguaje natural lo que necesita. Prioriza el Método 3 (JSON intermedio) para vistas complejas con múltiples fuentes de datos, y el Método 2 para casos donde ya existe un diseño visual aprobado por el cliente.

Repositorio oficial: github.com/essentialproject/essential-view-builder-mcp