Image Gen MCP

🚀 画像生成MCPサーバー

このMCPサーバーは、Stable Diffusion WebUI API（ForgeUI/AUTOMATIC-1111）を使用して、テキストから画像を生成する機能を提供します。

🚀 クイックスタート

この画像生成MCPサーバーを使用することで、テキスト入力から画像生成や画像のアップスケールを行うことができます。以下に、サーバーのセットアップと使用方法を説明します。

📦 インストール

前提条件

• Node.js
• APIが有効になっているStable Diffusion WebUIインスタンスへのアクセス
• WebUIを起動する際に--apiフラグを使用する必要があります

セットアップ

1. リポジトリをクローンします：

git clone https://github.com/Ichigo3766/image-gen-mcp.git
cd image-gen-mcp

2. 依存関係をインストールします：

npm install

3. サーバーをビルドします：

npm run build

4. サーバーの設定を環境変数に追加します：

{
  "mcpServers": {
    "image-gen": {
      "command": "node",
      "args": [],
      "env": {
        "SD_WEBUI_URL": "http://localhost:7860",
        "SD_API_KEY": "your_api_key", // オプション、WebUIでAPIキーが有効になっている場合
        "SD_MODEL_NAME": "モデル名" // オプション、デフォルトはWebUIのデフォルトモデル
      }
    }
  }
}

✨ 主な機能

テキストから画像生成

/api/generate-imageエンドポイントを使用して画像を生成します。リクエストボディには以下の内容が含まれます：

{
  "prompt": "入力プロンプト",
  "negative_prompt": "除外プロンプト", // オプション、デフォルトは空
  "width": 512,
  "height": 512,
  "samples": 1,
  "num_inference_steps": 20,
  "safety_checker": true, // 不適切な内容の生成を防ぐセーフティチェッカーのオン/オフ、デフォルトは有効
  "enhance_prompt": true, // プロンプトの強化を有効にする、デフォルトは有効
  "seed": null // ランダムシード、オプション、デフォルトはランダム値
}

画像アップスケール

/api/upscale-imagesエンドポイントを使用して画像を拡大します。リクエストボディには以下の内容が含まれます：

{
  "images": ["image1.jpg", "image2.png"], // 拡大する画像ファイルパスの配列
  "resize_mode": 0, // 0は比率で拡大、1は固定サイズ、デフォルトは環境変数から取得
  "upscaling_resize": 4, // resize_mode=0の場合の拡大倍率、デフォルトは環境変数から取得
  "upscaling_resize_w": 1024, // resize_mode=1の場合の目標幅（ピクセル）、デフォルトは環境変数から取得
  "upscaling_resize_h": 1024, // resize_mode=1の場合の目標高さ（ピクセル）、デフォルトは環境変数から取得
  "upscaler_1": "RealESRGAN_x4Plus", // 主要なアップスケーラーモデル、デフォルトは環境変数から取得
  "upscaler_2": null, // 二次的なアップスケーラーモデル、デフォルトはnull
  "output_path": "upscaled_images" // 拡大後の画像の出力ディレクトリ、デフォルトはカレントディレクトリ/upscaled-images
}

💻 使用例

基本的な使用法

以下は、テキストから画像を生成するための基本的なリクエストの例です：

{
  "prompt": "美しい風景",
  "width": 512,
  "height": 512
}

高度な使用法

画像のアップスケールを行うための高度なリクエストの例です：

{
  "images": ["original_image.jpg"],
  "resize_mode": 0,
  "upscaling_resize": 4
}

🔧 開発

自動再構築機能付きで開発するには、以下のコマンドを実行します：

npm run watch

エラーハンドリング

一般的な問題と解決策：

1. Stable Diffusion WebUIが--apiフラグで実行されていることを確認してください。
2. WebUIのURLがMCPサーバーからアクセス可能であることを確認してください。
3. 認証を使用している場合は、資格情報が正しいことを確認してください。
4. 出力ディレクトリが存在し、書き込み権限があることを確認してください。
5. 画像を拡大する際は、入力画像ファイルが存在し、読み取り可能であることを確認してください。

📄 ライセンス

このMCPサーバーはMITライセンスの下でライセンスされています。これは、あなたがソフトウェアを自由に使用、変更、配布できることを意味しますが、MITライセンスの条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。