Printify MCP

🚀 Printify 項目文檔

本項目倉庫包含一個用於管理 Printful 應用程序產品的 MCP（中心控制面板）服務器。藉助該服務器，用戶可通過 API 對產品進行創建、讀取、更新和刪除等操作。

✨ 主要特性

• Printful API 集成：與 Printful 平臺無縫對接，輕鬆實現產品的創建與管理。
• 圖片上傳支持：支持將圖片直接上傳至 Printful 服務。
• 日誌記錄：提供詳細的服務器端日誌，方便進行調試與監控。

📦 安裝指南

要運行這個項目，需要滿足以下條件：

1. 安裝 Node.js 和 npm，確保系統上已安裝 Node.js 14+ 和 npm 6+。
2. 安裝 Docker，用於構建和運行容器化的服務。
3. 克隆倉庫，從 GitHub 克隆此倉庫到本地開發環境。

快速開始

1. 克隆倉庫：

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

2. 安裝依賴：

npm install

3. 啟動項目：

• 使用 Docker Compose：

docker-compose up --build

• 或者直接運行：

npm run dev

💻 使用示例

基礎用法

以下是一個使用此 MCP 創建產品的簡單示例：

import { createProduct } from './printify-api';

const main = async () => {
    try {
        const product = await createProduct({
            title: 'My New Product',
            description: 'This is a test product.',
            images: ['path/to/image1.jpg', 'path/to/image2.jpg']
        });
        console.log('Product created successfully:', product);
    } catch (error) {
        console.error('Error creating product:', error.message);
    }
};

main();

📚 詳細文檔

如需瞭解代碼的詳細信息，請參考以下文檔文件：

• index.ts 文檔
• printify-api.ts 文檔
• replicate-client.ts 文檔

🔧 技術細節

技術棧

• 語言框架：Node.js 和 TypeScript
• 構建工具：Docker 容器化部署
• 依賴管理：npm 包管理器

代碼庫說明

項目源代碼位於 src 文件夾中，以下是關鍵文件的簡要說明：

1. index.ts：項目的主入口文件，負責初始化和運行 MCP 服務器。
2. printify-api.ts：實現與 Printful API 的交互，包括產品創建、讀取、更新和刪除功能。
3. replicate-client.ts：用於處理圖片上傳的客戶端模塊。

第三方依賴

項目使用以下 npm 包：

• @types/node：Node.js 類型定義
• express：Web 框架
• typescript：靜態類型支持
• @types/express：Express 類型定義
• dotenv：環境變量管理
• multer：文件上傳處理

故障排除

常見問題

Printful API 客戶端未初始化

若遇到錯誤信息“Printful API client is not initialized”，請檢查以下內容：

1. 確認 .env 文件中的 PRINTFUL_API_KEY 環境變量是否正確設置。
2. 驗證 API 密鑰的有效性和權限。

Replicate 客戶端未初始化

若遇到錯誤信息“Replicate client is not initialized”，請檢查以下內容：

1. 確認 .env 文件中的 REPLICATE_API_TOKEN 是否正確設置。
2. 驗證 API 令牌的有效性和權限。

創建產品時出錯

若在創建產品過程中出現錯誤，請檢查以下內容：

1. 確保使用的 blueprint ID 和 print provider ID 正確且有效。
2. 檢查上傳的圖片是否符合 Printful 的格式和大小要求。

聯繫方式

如需幫助或報告問題，請聯繫項目維護人員：support@printify.com

項目結構

printify-mcp/
├── src/                 # 源代碼文件夾
│   ├── index.ts         # 項目入口點
│   ├── printify-api.ts  # Printful API 實現模塊
│   └── replicate-client.ts # 圖片上傳處理模塊
├── docs/                # 文檔文件夾
│   ├── index.ts.md      # index.ts 的詳細文檔
│   └── ...
├── package.json        # 項目依賴和腳本信息
├── docker-compose.yml  # Docker 容器配置文件
└── .env.example        # 環境變量示例文件

貢獻指南

如果希望為這個項目做貢獻，請遵循以下步驟：

1. 叉建華克倉庫：git clone https://github.com/username/printify-mcp.git
2. 創建功能分支：git checkout -b feature/new-feature
3. 提交更改：git add . && git commit -m 'Add new feature'
4. 推送到遠程倉庫：git push origin feature/new-feature
5. 提交 Pull Request 到主分支。

📄 許可證

項目使用 MIT 許可證，具體內容如下：

MIT License

附錄

命令行工具

• 構建 Docker 鏡像：

docker build -t printify-mcp .

• 運行容器：

docker run -p 3000:3000 --env-file .env printify-mcp

環境變量

在 .env 文件中，至少需要設置以下環境變量：

PRINTFUL_API_KEY=your_api_key_here
REPLICATE_API_TOKEN=your_token_here
NODE_ENV=development
PORT=3000

圖片上傳格式要求

Printful 支持的圖片格式包括 JPG、PNG 和 GIF。圖片的最大尺寸為 5000px × 5000px，文件大小不超過 20MB。

感謝您對 Printify 的支持！如果有任何問題，請隨時聯繫我們的支持團隊。