FindMCP Logo FindMCP.info
Printify MCP Server

Printify MCP Server

site icon
2025.04.20 2
TypeScriptAI 集成按需打印产品管理内容生成其它
Printify MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于将 AI 助手与 Printify 的按需打印平台集成。它允许 AI 助手通过 MCP 标准创建和管理按需打印产品，使用 AI 生成设计，并处理产品管理的各个方面。
View on GitHub

Overview

基本能力

产品定位

Printify MCP Server 是一个桥梁，连接 AI 助手（如 Claude）和 Printify 的按需打印平台，通过 MCP 标准提供结构化的 Printify 功能。

核心功能

  1. Printify API 集成
  2. 认证：使用 API 密钥初始化 Printify API 客户端
  3. 商店：列出和管理 Printify 商店
  4. 产品：创建、读取、更新、删除和发布产品
  5. 目录：浏览蓝图、打印提供商和变体

  6. 图像：上传图像用于产品设计

  7. AI 图像生成

  8. 与 Replicate 集成，使用 Flux 1.1 Pro 模型生成图像

  9. 结合工作流：生成图像并直接上传到 Printify

  10. 文档

  11. 工具内文档：全面的产品创建文档

  12. 工作流指导：逐步创建产品的指南

  13. 提示

  14. 生成产品描述：基于产品详情生成吸引人的产品描述

适用场景

  1. 创建带有 AI 生成设计的 T 恤
  2. 管理现有产品
  3. 批量上传和生成产品图像
  4. 自动化产品发布流程

工具列表

  1. 商店管理
  2. get-printify-status：获取 Printify API 客户端状态
  3. list-shops：列出所有可用商店

  4. switch-shop：切换到不同的商店

  5. 产品工具

  6. list-products：列出商店中的产品
  7. get-product：获取特定产品的详情
  8. create-product：创建新产品
  9. update-product：更新现有产品
  10. delete-product：删除产品

  11. publish-product：发布产品到销售渠道

  12. 目录工具

  13. get-blueprints：获取可用蓝图列表
  14. get-blueprint：获取特定蓝图的详情
  15. get-print-providers：获取特定蓝图的打印提供商

  16. get-variants：获取特定蓝图和打印提供商的变体

  17. 图像工具

  18. generate-and-upload-image：生成图像并上传到 Printify
  19. generate-image：生成图像并保存到本地文件

  20. upload-image：上传图像到 Printify 账户

  21. 提示

  22. generate-product-description：生成产品描述

常见问题解答

  1. Printify API 客户端未初始化
  2. 检查 .env 文件中的 PRINTIFY_API_KEY 是否正确设置

  3. 确保 API 密钥有效且具有正确的权限

  4. Replicate API 客户端未初始化

  5. 检查 .env 文件中的 REPLICATE_API_TOKEN 是否正确设置

  6. 确保 API 令牌有效且具有正确的权限

  7. 创建产品时出错

  8. 检查蓝图 ID 和打印提供商 ID 是否有效
  9. 确保变体 ID 对所选蓝图和打印提供商有效
  10. 确保打印区域中的图像 ID 有效且可访问

  11. 确保请求中包含所有必填字段

  12. 上传图像时出错

  13. 检查图像是否为有效格式（PNG、JPEG 等）
  14. 确保图像不太大（最大大小为 10MB）
  15. 如果使用 URL，确保它是公开可访问的
  16. 如果使用本地文件，确保它存在且可读

使用教程

使用依赖

  1. Node.js (v18 或更高版本)
  2. npm (v7 或更高版本)
  3. Printify API 密钥
  4. Replicate API 令牌（用于 AI 图像生成）
  5. ImgBB API 密钥（如果使用 Flux 1.1 Pro Ultra 模型）

安装教程

# 克隆仓库
git clone https://github.com/tsavo/printify-mcp.git
cd printify-mcp

# 安装依赖
npm install

# 构建项目
npm run build

配置

  1. 创建 .env 文件并设置以下变量：
PRINTIFY_API_KEY=your_printify_api_key
PRINTIFY_SHOP_ID=your_shop_id (可选)
REPLICATE_API_TOKEN=your_replicate_api_token (可选)
IMGBB_API_KEY=your_imgbb_api_key (如果使用 Flux 1.1 Pro Ultra 模型)

调试方式

  1. 启动服务器：
npm start
  1. 开发模式（自动重新加载）：
npm run dev
  1. 测试连接：
Can you check the status of my Printify connection?

许可证

该项目遵循 ISC 开源许可条款，请参阅 ISC 了解完整条款。