Printify MCP Server 使用说明

项目简介

Printify MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接人工智能助手（如 Claude）与 Printify 按需打印平台。通过此服务器，AI助手可以自动化创建和管理 Printify 平台上的按需打印商品，包括商品设计、产品管理等环节，极大地提升工作效率。

主要功能点

Printify API 集成: 提供全面的 Printify API 访问能力，包括店铺和商品管理、目录浏览、图片上传等功能。
AI 图像生成: 集成 Replicate AI 图像生成服务，支持使用文本提示词生成商品设计所需的图像。
自动化工作流: 结合 Printify API 和 AI 图像生成，实现从设计生成到商品发布的完整自动化工作流程。
工具和 Prompt 模板: 提供丰富的工具 (Tools) 用于 Printify 平台操作，以及 Prompt 模板 (Prompts) 用于生成商品描述等内容。
详细文档: 提供完善的工具使用文档和工作流示例，方便用户快速上手。

安装步骤

克隆仓库

git clone https://github.com/tsavo/printify-mcp.git
cd printify-mcp

安装依赖
```
npm install
```
构建项目
```
npm run build
```

服务器配置

MCP 服务器需要配置以下信息才能与 MCP 客户端（如 Claude Desktop）连接。在 Claude Desktop 的 MCP Servers 设置中，添加服务器并配置如下：

{
  "server name": "Printify MCP Server",
  "transport type": "Command",
  "command": "printify-mcp",
  "arguments": "",
  "notes": "使用 npm 全局安装时，command 设置为 printify-mcp 即可直接运行服务器",
  "transport type": "Command",
  "command": "npx",
  "arguments": "@tsavo/printify-mcp",
  "notes": "如果不想全局安装，command 设置为 npx，arguments 设置为 @tsavo/printify-mcp"
}

或者，如果使用 Docker 运行服务器，配置如下：

{
  "server name": "Printify MCP Docker",
  "transport type": "Command",
  "command": "docker",
  "arguments": "exec -i printify-mcp node dist/index.js",
  "notes": "command 设置为 docker，arguments 设置为 exec -i printify-mcp node dist/index.js，假设 Docker 容器名为 printify-mcp"
}

重要提示：

API 密钥: 运行服务器前，请务必配置 Printify API Key 和 Replicate API Token 等必要的环境变量。推荐使用 '.env' 文件配置，具体方法请参考仓库 README 文档的 "Configuration" 章节。
启动命令: 上述 'command' 和 'arguments' 配置是 Claude Desktop 连接 MCP 服务器的关键，请根据实际部署方式选择正确的配置。

基本使用方法

启动服务器 在项目根目录下，运行以下命令启动 Printify MCP Server：
```
npm start
```
或使用开发模式启动：
```
npm run dev
```
如果使用 Docker 运行，请参考 README 文档的 "Usage" 章节。
连接 Claude Desktop 在 Claude Desktop 的 MCP Servers 设置中，添加并启用配置好的 Printify MCP Server。
与 AI 助手交互 在 Claude Desktop 中，即可通过自然语言指令调用 Printify MCP Server 提供的工具，例如：
- 查询 Printify 连接状态: 'Can you check the status of my Printify connection?'
- 列出 Printify 店铺: 'Can you list my Printify shops?'
- 创建商品: 可以使用 'create_product' 工具创建新的 Printify 商品。
- 生成商品图片: 使用 'generate_and_upload_image' 工具结合 AI 图像生成和 Printify 图片上传功能。
更多工具和使用示例，请参考仓库 README 文档的 "Available Tools" 和 "Workflow Examples" 章节。

关键词

Printify MCP Server 使用说明

信息