Brand-to-Theme MCP Server

品牌转主题 MCP 服务

用于将品牌标识 PDF 转换为功能完整的 Shopify 主题的 MCP 服务。

描述

此 MCP 服务提供一组工具，用于自动将企业品牌标识手册 PDF 转换为功能完整的 Shopify 主题，同时保持品牌标识一致性。

它使用先进的 PDF 提取和代码生成技术，将品牌视觉元素（颜色、字体等）转换为完整且可安装的 Shopify 主题。

特性

• PDF 提取：分析 PDF，提取调色板、字体和其他设计元素
• 生成 Design Tokens：将提取的元素转换为标准化的设计令牌
• 创建 Shopify 主题：根据品牌标识生成完整的主题文件
• 与 Shopify 集成：支持直接将主题安装到已连接的商店
• 与 Figma 集成：兼容从 Figma 提取的组件（通过 Figma MCP）

MCP 工具

该服务提供以下 MCP 工具：

1. extract_pdf_branding

从 PDF 文件中提取视觉元素和品牌标识。

参数：

• pdfPath：企业品牌标识手册 PDF 文件的路径
• extractOptions：提取选项（颜色、字体、Logo）

2. generate_design_tokens

根据提取的品牌标识生成设计令牌。

参数：

• brandingData：提取的品牌标识数据
• figmaData：可选的 Figma 提取数据
• format：令牌的输出格式（json、css、scss）

3. create_shopify_theme

根据设计令牌生成 Shopify 主题。

参数：

• designTokens：生成的设计令牌
• themeName：要生成的主题名称
• outputPath：主题文件的保存路径

4. preview_shopify_theme

生成 Shopify 主题的预览。

参数：

• themePath：主题文件的路径
• previewType：要生成的预览类型（thumbnail、full）

5. install_shopify_theme

将生成的主题安装到已连接的 Shopify 商店。

参数：

• themePath：主题文件的路径
• installationType：安装为新主题或更新现有主题
• existingThemeId：要更新的现有主题 ID（如适用）
• setAsMain：将其设为商店的主主题

安装

1. 克隆此代码库：

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

2. 安装依赖项：

npm install

3. 编译项目：

npm run build

4. 在 MCP 配置文件中配置 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": []
    }
  }
}

基本用法

1. 从 PDF 中提取品牌元素：

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

2. 生成设计令牌：

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

3. 创建 Shopify 主题：

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

4. 将主题安装到 Shopify：

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

要求

• Node.js v16+
• Shopify Partner Account（用于安装主题）
• 兼容 Claude 的 MCP