Stable Diffusion WebUI

🚀 画像生成 MCP サーバー

この MCP サーバーは、Stable Diffusion WebUI API（ForgeUI/AUTOMATIC-1111）をベースに、文字から画像を生成する機能を提供します。

🚀 クイックスタート

この画像生成 MCP サーバーを使用することで、Stable Diffusion WebUI API を通じて文字から高品質な画像を生成できます。以下に、サーバーのセットアップと使用方法を説明します。

📦 インストール

前提条件

• 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": [
        "/path/to/image-gen-mcp/build/index.js"
      ],
      "env": {
        "NODE_ENV": "production",
        "PORT": "3000",
        "SD_WEBUI_URL": "http://localhost:7860",
        "AUTH_ENABLED": "false",
        "OUTPUT_DIR": "/path/to/output",
        "UPSCALER_1": "RealESRGAN_x2plus",
        "UPSCALER_2": "RealSR_x4plus"
      }
    }
  }
}

✨ 主な機能

ツール

画像生成

文字から画像への変換モデルを使用して、高品質な画像を生成します。

SD モデルの取得

現在利用可能な Stable Diffusion モデルのリストを取得します。

SD モデルの設定

デフォルトの Stable Diffusion モデルを設定します。

解像度のアップスケーリング

Stable Diffusion を使用して画像の解像度を向上させます。

パラメータ

画像生成

• prompt (必須): 画像の説明を記述するテキストプロンプト。
• negative_prompt: 画像に含まれてほしくない内容のプロンプト。
• width (オプション、デフォルト 512): 出力画像の幅。
• height (オプション、デフォルト 512): 出力画像の高さ。
• samples (オプション、デフォルト 1): 生成する画像の数。
• num_inference_steps (オプション、デフォルト 20): 推論ステップの数。

SD モデルの取得

パラメータは必要ありません。利用可能なすべてのモデルのリストが返されます。

SD モデルの設定

• model_id (必須): 設定するモデルの ID。

解像度のアップスケーリング

• images (必須): 解像度を上げる画像ファイルのパスの配列。
• resize_mode (オプション、デフォルトは環境変数): 0 は倍率モード、1 は次元モードを表します。
• upscaling_resize (オプション、デフォルトは環境変数): 倍率モードでの拡大率。
• upscaling_resize_w (オプション、デフォルトは環境変数): 次元モードでの目標幅（ピクセル単位）。
• upscaling_resize_h (オプション、デフォルトは環境変数): 次元モードでの目標高さ（ピクセル単位）。
• upscaler_1 (オプション、デフォルトは環境変数): メインのアップスケーラーモデル。
• upscaler_2 (オプション、デフォルトは環境変数): サブのアップスケーラーモデル。
• output_path (オプション、デフォルトは現在のディレクトリ): アップスケーリング後の画像の出力先パス。

💻 使用例

基本的な使用法

開発時に自動再構築を使用するには、以下のコマンドを実行します:

npm run watch

🔧 エラー処理

一般的な問題とその解決策:

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

📄 ライセンス

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