About Brand-to-Theme MCP Server
Brand-to-Theme MCP Server turns PDF brand guidelines into Shopify theme files, with optional Figma data for design tokens. It is intended for teams creating or updating Shopify storefront themes from established brand materials.
Key features
- 01Extract colors and typography from PDFs
- 02Generate design tokens in JSON, CSS, or SCSS
- 03Create and preview Shopify themes
- 04Install or update themes in Shopify
- 05Use optional Figma component data
Use cases
- 01Building a Shopify theme from brand guidelines
- 02Updating a store theme to reflect brand changes
- 03Using Figma data alongside PDF branding
MCP support
The MCP server exposes tools to extract PDF branding, generate design tokens, create and preview Shopify themes, and install or update a theme in a connected Shopify store.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEBrand-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 corporativaextractOptions: 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ídosfigmaData: Datos opcionalmente extraídos de Figmaformat: 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 generadosthemeName: Nombre del tema a generaroutputPath: 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 temapreviewType: 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 temainstallationType: Instalar como tema nuevo o actualizar un tema existenteexistingThemeId: 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.