image-gen MCP サーバー

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

インストール

前提条件

• Node.js

• API が有効になっている安定した Diffusion WebUI インスタンスへのアクセス

• WebUIを起動するときには--apiフラグが有効になっている必要があります

設定

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

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

3. サーバーを構築します。

4. サーバー構成を環境に追加します。

環境変数を実際の値に置き換えます。

• SD_WEBUI_URL : Stable Diffusion WebUIインスタンスのURL

• SD_AUTH_USER : 基本認証のユーザー名（有効な場合）

• SD_AUTH_PASS : 基本認証のパスワード（有効な場合）

• SD_OUTPUT_DIR : 生成された画像が保存されるディレクトリ

• SD_RESIZE_MODE : デフォルトのアップスケーリングモード（乗数は0、寸法は1）

• SD_UPSCALE_MULTIPLIER : resize_mode が 0 の場合のデフォルトのアップスケール乗数

• SD_UPSCALE_WIDTH : resize_mode が 1 の場合のデフォルトのターゲット幅

• SD_UPSCALE_HEIGHT : resize_mode が 1 の場合のデフォルトのターゲットの高さ

• SD_UPSCALER_1 : デフォルトのプライマリアップスケーラモデル

• SD_UPSCALER_2 : デフォルトのセカンダリアップスケーラモデル

特徴

ツール

• generate_image - 安定拡散法を使用して画像を生成する

  • パラメータ:

    • prompt （必須）: 希望する画像のテキスト説明

    • negative_prompt : 画像から除外するもの

    • steps ：サンプリングステップ数（デフォルト：4、範囲：1〜150）

    • width : 画像の幅（デフォルト: 1024、範囲: 512-2048）

    • height : 画像の高さ（デフォルト: 1024、範囲: 512-2048）

    • cfg_scale : CFGスケール（デフォルト: 1、範囲: 1-30）

    • sampler_name : サンプリングアルゴリズム（デフォルト: "Euler")

    • scheduler_name : スケジューラアルゴリズム（デフォルト: "Simple"）

    • seed : ランダムシード（ランダムの場合は -1）

    • batch_size : 生成する画像の数（デフォルト: 1、最大: 4）

    • restore_faces : 顔の復元を有効にする

    • tiling : タイル化可能な画像を生成する

    • output_path : 生成された画像のカスタム出力パス

• get_sd_models - 利用可能な安定拡散モデルのリストを取得します

  • パラメータは必要ありません

  • モデル名の配列を返します

• set_sd_model - アクティブな安定拡散モデルを設定する

  • パラメータ:

    • model_name (必須): アクティブに設定するモデルの名前

• get_sd_upscalers - 利用可能なアップスケーラーモデルのリストを取得します

  • パラメータは必要ありません

  • アップスケーラー名の配列を返します

• upscale_images - 安定拡散法を使用して1つまたは複数の画像を拡大します

  • パラメータ:

    • images （必須）: アップスケールする画像ファイルのパスの配列

    • resize_mode : 乗数モードの場合は 0、次元モードの場合は 1 (デフォルト: env から)

    • upscaling_resize : resize_mode=0 の場合のアップスケール乗数（デフォルト: env から）

    • upscaling_resize_w : resize_mode=1 の場合のターゲット幅（ピクセル単位）（デフォルト: env から）

    • upscaling_resize_h : resize_mode=1 の場合のターゲットの高さ（ピクセル単位）（デフォルト: env から）

    • upscaler_1 : プライマリアップスケーラーモデル（デフォルト: envから）

    • upscaler_2 : セカンダリアップスケーラモデル（デフォルト: envから）

    • output_path : アップスケールされた画像のカスタム出力ディレクトリ

発達

自動リビルドを使用した開発の場合:

エラー処理

よくある問題と解決策:

1. Stable Diffusion WebUIが--apiフラグ付きで実行されていることを確認してください

2. MCPサーバーを実行している場所からWebUI URLにアクセスできるかどうかを確認します。

3. 認証を使用する場合は、資格情報が正しいことを確認してください

4. 出力ディレクトリが存在し、書き込み権限があることを確認します

5. アップスケールする場合、入力画像ファイルが存在し、読み取り可能であることを確認してください。

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。