Token导航 LogoToken导航TokenDH.com
Shopify Web Replicator logo
运维云端未说明官方级别未说明来源级核验

Shopify Web Replicator

MCP Server

Shopify Web Replicator是一个本地优先的多客户端产品,用于将公共店面转换为可审查的输出,支持Shopify主题和Hydrogen工作空间生成。

工具数

5

提示词数

0

GitHub Stars

0

资源数

0
本地开发TypeScript云端部署

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

connortessaro

提供方

connortessaro

最后核验

2026/5/17 20:20

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

Shopify网络复制器

Shopify Web Replicator是本地首款MCP产品,用于将公共店面转化为可审查的输出。

它目前支持两个轨道:

  • replicate_site_to_theme:确定性Shopify主题生成和操作员审查的稳定默认路径
  • replicate_site_to_hydrogen:使用Playwright发现和现场Figma桥生成异步Hydrogen工作空间的高级/测试路径

回购包括共享相同引擎行为的配套API和web UI表面,因此团队可以在代理驱动和人工审核工作流之间移动,而无需切换工具。MCP客户端可以通过本地连接 stdio 或可流式传输的HTTP,具体取决于客户端。

团队首发

  1. pnpm install
  2. pnpm build
  3. cp config/destination-stores.example.json config/destination-stores.json
  4. pnpm dev 用于手表模式
  5. 打开MCP或UI流 docs/mcp-setup.md / docs/operator-runbook.md

工作区布局

  • apps/mcp:具有stdio和可流式传输HTTP入口点的MCP服务器
  • apps/api:由同一复制引擎支持的配套HTTP API
  • apps/web:用于接收、工作审查和交接的配套操作员UI
  • packages/engine:MCP和API使用的共享确定性复制引擎
  • packages/shared:共享合同和管道类型
  • packages/theme-workspace:接收生成输出的Shopify主题工作区

脚本

  • pnpm dev:构建共享和引擎包,然后启动共享监视、引擎监视、API、web应用程序和MCP服务器监视
  • pnpm build:构建共享、引擎、API、web和MCP软件包
  • pnpm typecheck:在所有应用程序和软件包中运行TypeScript检查
  • pnpm test:按顺序运行共享、引擎、API、web和MCP测试
  • pnpm theme:check:在本地主题工作区上运行Shopify主题验证

运行时配置

  • REPLICATOR_DB_PATH

违约: .data/replicator.db

  • THEME_WORKSPACE_PATH

违约: packages/theme-workspace

  • REPLICATOR_HYDROGEN_ROOT

违约: generated-sites

  • REPLICATOR_CAPTURE_ROOT

违约: .data/captures

  • REPLICATOR_DESTINATION_STORES_PATH

违约: config/destination-stores.json

  • FIGMA_MCP_URL

违约: http://127.0.0.1:3845/mcp

这些变量影响MCP服务器、API和伴随网络切换流,因为它们都使用相同的引擎包。

目标存储是从本地JSON文件加载的。使用 config/destination-stores.example.json 作为本地模板 config/destination-stores.json.

MCP刀具表面

  • replicate_site_to_theme

在一个工具调用中运行源资格、参考捕获和确定性管道端到端,并返回终端切换有效载荷。

  • replicate_site_to_hydrogen

创建运行Playwright发现的异步Hydrogen复制作业, figma_import, figma_design_context后端推理和Hydrogen工作空间生成。

  • get_replication_job

按id加载持久作业。

  • list_replication_jobs

列出最近保留的作业,最新的先列出。

  • list_destination_stores

列出已配置的目标存储配置文件,以便代理可以选择有效的 destinationStore 运行复制之前的id。

一次性工具返回:

  • 作业标识和生命周期状态
  • 类型化源确认、捕获、分析、映射、生成、存储设置、商务、验证和集成快照
  • 生成的工件元数据和时间戳
  • 解析目标存储元数据(如果可用)
  • 运行时切换信息:主题工作区路径、捕获根路径和预览命令
  • 操作员审查的确定性下一步行动

主题流稳定

  1. 代理或配套UI选择配置的目标存储,并提交参考URL、可选页面类型和可选注释。
  2. 该引擎持久保存SQLite作业记录。
  3. 管道运行 source_qualification 首先,对于不受支持或非Shopify来源,它会快速失败。
  4. capture 使用Playwright捕获渲染的源代码,导出标题、导航链接、主CTA、图像资产、样式标记、路线提示,并在本地捕获根下保存捕获包以及桌面/移动屏幕截图。
  5. 然后,确定性管道运行 analysis, mapping, theme_generation, store_setup, commerce_wiring, validation, integration_check,以及 review.
  6. 主题生成会覆盖主题工作区中特定于稳定页面类型的部分和模板输出。
  7. 店铺设置计划撰写 config/generated-store-setup.json.
  8. 商业布线写 snippets/generated-commerce-wiring.liquid.
  9. 最终验证在完全生成的工作区上运行。
  10. 集成检查写入 config/generated-integration-report.json 并验证磁盘上生成的文件、商务入口点、部分代码段渲染、签出切换标记和最终验证状态。
  11. 最终结果是 needs_reviewfailed.

先进的氢气流量

  1. 一位代理人打来电话 replicate_site_to_hydrogenreferenceUrl, targetId,可选 targetLabel, notes,以及 seedRoutes.
  2. 该引擎创建了一个持久的氢气作业,并异步运行这些阶段:

- source_qualification - playwright_discovery - figma_import - figma_design_context - frontend_spec - backend_inference - hydrogen_generation - workspace_validation - review

  1. 生成的氢气工作空间写在 generated-sites/ 默认情况下。
  2. 工作流程取决于可到达的Figma MCP桥。如果网桥不可用,则作业将失败 figma_import 通过设计。

捕获工件

  • 捕获包写在 .data/captures/ 默认情况下。
  • 每次成功捕获都会写道:

- capture-bundle.json - desktop.jpg - mobile.jpg

  • 作业有效负载存储工件路径、提取的样式标记和路由提示,而不是在SQLite中嵌入大blob。

稳定的发电量

  • sections/generated-reference.liquid
  • sections/generated-homepage-reference.liquid
  • sections/generated-product-reference.liquid
  • sections/generated-collection-reference.liquid
  • templates/page.generated-reference.json
  • templates/index.generated-reference.json
  • templates/product.generated-reference.json
  • templates/collection.generated-reference.json
  • config/generated-store-setup.json
  • snippets/generated-commerce-wiring.liquid
  • config/generated-integration-report.json

配套HTTP API

  • POST /api/jobs
  • POST /api/hydrogen/jobs
  • GET /api/jobs/:jobId
  • GET /api/jobs?limit=
  • GET /api/runtime
  • GET /api/destination-stores

API使用相同的 packages/engine 编排器作为MCP服务器。

本地MCP设置

docs/mcp-setup.md 有关stdio启动的详细信息、可流式传输的HTTP设置、Figma网桥配置和环境覆盖。 docs/setup-guide.md 是面向客户的更广泛的设置指南。

配套操作流程

web应用程序对于手动审查稳定的主题工作流程仍然有用:

  1. 使用以下命令启动repo pnpm dev.
  2. 在web UI中提交作业或通过MCP创建作业。
  3. 打开作业详细信息或移交视图。
  4. 审查源资格、捕获工件路径、提取的路线/样式信号、生成的工件、验证输出、集成输出和下一步。
  5. shopify theme dev 在配置的工作区中,验证布局、内容、商务布线和购物车到收银台的切换。

Hydrogen目前更倾向于MCP优先,而不是web UI优先。使用 get_replication_job 或API检查这些作业并在 generated-sites/.

电流限制

  • 该管道仅限于本地,目前支持符合公共Shopify店面条件的来源。
  • 源代码捕获需要本地Playwright/Chromium运行时,目前目标是可以在浏览器会话中加载的公共Shopify店面。
  • 商店设置输出仍然是生成的计划,而不是Shopify管理员自动化。
  • 商业布线是基于确定性和本地路由的,而不是实时结账自动化。
  • 多页复制和签出自定义超出了此切片的范围。
  • Hydrogen+Figma路径是一个高级/测试版工作流程。它依赖于一个实时的Figma MCP桥,尚未被记录为一流的web UI审查流程。

目录标签

目录标签

本地开发TypeScript云端部署Shopify工具本地部署网站复制主题生成Hydrogen工作空间

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

none

工具数量(toolCount,工具数)

5

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP