Printify MCP

🚀 Printify プロジェクトドキュメント

このプロジェクトは、Printful アプリケーションの製品を管理するための MCP（マスターコントロールパネル）サーバーを提供します。MCP を通じて、ユーザーは API を使用して製品の作成、閲覧、更新、削除を行うことができます。

🚀 クイックスタート

このプロジェクトを実行するには、以下の条件を満たす必要があります。

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
     

✨ 主な機能

• Printful API 統合：Printful プラットフォームとシームレスに接続し、製品の作成と管理を実現します。
• 画像アップロードサポート：画像を直接 Printful サービスにアップロードできます。
• ログ記録：詳細なサーバー側ログを残し、デバッグと監視を容易にします。

📦 インストール

前提条件

• Node.js 14+ と npm 6+
• Docker

手順

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
     

💻 使用例

基本的な使用法

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：ファイルアップロードの処理

📄 ライセンス

このプロジェクトは 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 へのご支援ありがとうございます。何か問題があれば、サポートチームにお問い合わせください。