Image Generation MCP Server

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ファイルをご覧ください。