Brand-to-Theme MCP Server

Servidor MCP para convertir PDFs de identidad de marca en temas funcionales para Shopify.

Descripción

Este servidor MCP proporciona un conjunto de herramientas para automatizar la conversión de manuales de identidad corporativa en PDF a temas funcionales de Shopify, manteniendo la coherencia con la identidad de marca.

Utiliza tecnologías avanzadas de extracción de PDF y generación de código para transformar elementos visuales de marca (colores, tipografías, etc.) en un tema Shopify completo y listo para instalar.

Características

Extracción de PDF: Analiza PDFs para obtener paletas de colores, tipografías y otros elementos de diseño
Generación de Design Tokens: Convierte los elementos extraídos en tokens de diseño estandarizados
Creación de Temas Shopify: Genera archivos de tema completos basados en la identidad de marca
Integración con Shopify: Permite instalar el tema directamente en la tienda conectada
Integración con Figma: Compatible con componentes extraídos desde Figma (mediante MCP de Figma)

Herramientas MCP

El servidor expone las siguientes herramientas MCP:

1. `extract_pdf_branding`

Extrae elementos visuales e identidad de marca desde un archivo PDF.

Parámetros:

pdfPath: Ruta al archivo PDF del manual de identidad corporativa
extractOptions: Opciones de extracción (colores, tipografía, logos)

2. `generate_design_tokens`

Genera tokens de diseño a partir de la identidad de marca extraída.

Parámetros:

brandingData: Datos de identidad de marca extraídos
figmaData: Datos opcionalmente extraídos de Figma
format: Formato de salida para los tokens (json, css, scss)

3. `create_shopify_theme`

Genera un tema de Shopify basado en tokens de diseño.

Parámetros:

designTokens: Tokens de diseño generados
themeName: Nombre del tema a generar
outputPath: Ruta donde guardar los archivos del tema

4. `preview_shopify_theme`

Genera una vista previa del tema de Shopify.

Parámetros:

themePath: Ruta a los archivos del tema
previewType: Tipo de vista previa a generar (thumbnail, full)

5. `install_shopify_theme`

Instala el tema generado en la tienda Shopify conectada.

Parámetros:

themePath: Ruta a los archivos del tema
installationType: Instalar como tema nuevo o actualizar un tema existente
existingThemeId: ID del tema existente a actualizar (si es relevante)
setAsMain: Establecer como tema principal de la tienda

Instalación

Clona este repositorio:

git clone https://github.com/mmokarzel/brand-to-theme-mcp-server.git
cd brand-to-theme-mcp-server

Instala las dependencias:

npm install

Compila el proyecto:

npm run build

Configura el servidor MCP en tu archivo de configuración MCP:

{
  "mcpServers": {
    "github.com/mmokarzel/brand-to-theme-mcp-server": {
      "command": "node",
      "args": [
        "/ruta/a/brand-to-theme-mcp/build/index.js"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Uso Básico

Extrae elementos de marca desde un PDF:

const brandingData = await extract_pdf_branding({
  pdfPath: "/ruta/a/manual-identidad.pdf"
});

Genera tokens de diseño:

const designTokens = await generate_design_tokens({
  brandingData: brandingData,
  format: "json"
});

Crea un tema Shopify:

const themeResult = await create_shopify_theme({
  designTokens: designTokens,
  themeName: "MiMarca Theme"
});

Instala el tema en Shopify:

const installResult = await install_shopify_theme({
  themePath: themeResult.path,
  installationType: "new",
  setAsMain: true
});

Requisitos

Node.js v16+
Shopify Partner Account (para instalar temas)
MCP compatible con Claude

Brand-to-Theme MCP Server