image-gen MCP サーバー

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

インストール

前提条件

• Node.js

• API が有効になっている安定した 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": [
        "/path/to/image-gen-mcp/build/index.js"
      ],
      "env": {
        "SD_WEBUI_URL": "http://your-sd-webui-url:7860",
        "SD_AUTH_USER": "your-username",  // Optional: if authentication is enabled
        "SD_AUTH_PASS": "your-password",  // Optional: if authentication is enabled
        "SD_OUTPUT_DIR": "/path/to/output/directory",
        "SD_RESIZE_MODE": "0",           // Optional: upscaling mode (0=multiplier, 1=dimensions)
        "SD_UPSCALE_MULTIPLIER": "4",    // Optional: default upscale multiplier
        "SD_UPSCALE_WIDTH": "512",       // Optional: default upscale width
        "SD_UPSCALE_HEIGHT": "512",      // Optional: default upscale height
        "SD_UPSCALER_1": "R-ESRGAN 4x+", // Optional: default primary upscaler
        "SD_UPSCALER_2": "None"          // Optional: default secondary upscaler
      }
    }
  }
}

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

• 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 : デフォルトのセカンダリアップスケーラモデル

Related MCP server: Image Generator MCP Server

特徴

ツール

• 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 : アップスケールされた画像のカスタム出力ディレクトリ

発達

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

npm run watch

エラー処理

よくある問題と解決策:

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

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

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

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

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

ライセンス

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