使用说明

项目简介

TailorKit MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端，旨在连接 AI 助手（如 Claude）与 TailorKit API。它为电商平台提供强大的商品定制化框架，使得用户可以通过自然语言与 AI 助手交互，管理和操作商品模板，实现互动式的个性化定制体验。

主要功能点

模板列表查询 (get_list_templates): 允许 AI 助手查询指定 Shopify 店铺的商品模板列表，支持分页、排序和关键词过滤。
模板详情获取 (get_detail_template): 允许 AI 助手获取指定 Shopify 店铺中特定商品模板的详细信息，包括图层和设置。
模板创建 (create_template): 允许 AI 助手为指定 Shopify 店铺创建新的商品模板，可以设置模板名称、尺寸和初始图层配置。
模板图层列表查询 (get_list_layers_of_template): 允许 AI 助手获取指定商品模板的所有图层信息。

安装步骤

通过 npm 安装:

npm install @sellersmith/tailorkit-mcp

通过 GitHub 安装:

git clone https://github.com/sellersmith/tailorkit-mcp.git
cd tailorkit-mcp
npm install
npm run build

服务器配置

要将 TailorKit MCP 服务器与 MCP 客户端（例如 Claude Desktop）连接，您需要在客户端的配置文件中添加服务器配置信息。以下是针对 Claude Desktop 的配置示例，请根据您的 MCP 客户端进行相应配置：

{
  "mcpServers": {
    "tailorkit-mcp": {
      "command": "node",
      "args": ["path/to/your/dist/index.js"],
      "env": {
        "HOST": "https://your-api-host.com",  // 替换为您的 TailorKit API Host URL
        "ACCESS_TOKEN": "your-access-token"  // 替换为您的 TailorKit API 访问令牌
      }
    }
  }
}

配置参数说明:

'server name': 'tailorkit-mcp' (服务器名称，可自定义)
'command': 'node' (启动服务器的命令，这里使用 Node.js 运行时)
'args': '["path/to/your/dist/index.js"]' (启动命令的参数，指向编译后的服务器入口文件。请将 'path/to/your/dist/index.js' 替换为实际路径)
'env': 环境变量配置
- 'HOST': TailorKit API 的 Host URL。请务必替换为您的实际 API Host URL。
- 'ACCESS_TOKEN': TailorKit API 的访问令牌。请务必替换为您的实际访问令牌。 您可以在 TailorKit 的设置页面生成访问令牌。

基本使用方法

启动服务器: 根据安装方式，在项目根目录下运行 'node dist/index.js' 或其他启动命令。
配置 MCP 客户端: 将上述服务器配置信息添加到您的 MCP 客户端配置文件中，并确保配置参数正确。
通过 AI 助手调用工具: 在 MCP 客户端中，您可以指示 AI 助手使用 TailorKit MCP 服务器提供的工具来管理商品模板。例如，您可以对 Claude 说：
- "列出 shop 域名为 example.myshopify.com 的模板" (对应 'get_list_templates' 工具)
- "获取模板 ID 为 12345，shop 域名为 example.myshopify.com 的详细信息" (对应 'get_detail_template' 工具)
- "为 shop 域名为 example.myshopify.com 创建一个名为 '夏季促销' 的模板，尺寸为 1000x1000 像素" (对应 'create_template' 工具)
- "列出模板 ID 为 12345，shop 域名为 example.myshopify.com 的所有图层" (对应 'get_list_layers_of_template' 工具)

AI 助手会根据您的指令，调用相应的工具并返回结果。

关键词