Brand-to-Theme

Converts brand identity PDFs into Shopify themes by extracting branding data, generating design tokens, producing themes, and enabling direct Shopify installation.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP server automates turning brand identity PDFs into Shopify themes. It extracts colors, typography, and logos from PDFs, converts them into design tokens, builds a ready-to-install Shopify theme, and can install it on your connected store or generate a preview for review.

How to use

You work with an MCP client to orchestrate the end-to-end workflow. Start by running the local MCP server that compiles branding data into a Shopify theme, then invoke each tool in sequence to extract branding data, generate design tokens, create a Shopify theme, preview it, and install it.

How to install

Prerequisites you need before installation: Node.js v16 or newer and a MCP-enabled environment. You also require an MCP client to communicate with the server.

Install dependencies and build the server locally. Run the following commands in your terminal from the project root:

npm install
npm run build

Configuration and startup

Register the MCP server in your MCP configuration so the client can discover and call its tools. Use the following configuration snippet in your MCP config file:

{
  "mcpServers": {
    "brand_to_theme_mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/ruta/a/brand-to-theme-mcp/build/index.js"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Run the server and execute tasks

Start the MCP server via your standard runtime channel using the stdio configuration you defined. Once running, you can chain the following actions through your MCP client:

Extract branding from a PDF
Generate design tokens from the extracted branding
Create a Shopify theme using those tokens
Preview the theme to review visuals
Install the theme to your Shopify store (as a new theme or update an existing one)

Available tools

extract_pdf_branding

Extracts visual identity elements from a brand PDF, including colors, typography, and logos.

generate_design_tokens

Generates standardized design tokens from branding data and optional Figma data, with output formats like json, css, or scss.

create_shopify_theme

Creates a complete Shopify theme based on the design tokens.

preview_shopify_theme

Produces a preview of the generated Shopify theme, either as a thumbnail or full view.

install_shopify_theme

Installs the generated theme to a connected Shopify store, either as a new theme or by updating an existing one and optionally setting it as the main theme.