Flux Image Generator

FLUX 画像生成 MCP サーバー

Black Forest Lab の FLUX モデルを使用して画像を生成する MCP（Model Context Protocol）サーバーです。最新の MCP SDK（v1.7.0）を使用しています。

機能

• テキストプロンプトに基づいて画像を生成します
• 画像のサイズ、プロンプトのアップサンプリング、安全設定をカスタマイズできます
• 生成した画像をローカルに保存します
• 複数のプロンプトから画像を一括生成します

前提条件

• Node.js（v18.0.0 以上）
• Black Forest Lab API キー（https://api.bfl.ml で取得できます）

インストール

ソースから

1. このリポジトリをクローンします
2. 依存関係をインストールします：

npm install

3. .env.example を基に .env ファイルを作成し、Black Forest Lab API キーを追加します：

BFL_API_KEY=your_api_key_here

4. プロジェクトをビルドします：

npm run build

npm を使用する場合

npm install -g @modelcontextprotocol/server-flux-image-generator

使用方法

MCP サーバーの起動

次のコマンドでサーバーを起動します：

npm start

自動再コンパイルを有効にして開発する場合：

npm run watch

MCP クライアントとの統合

このサーバーを MCP クライアント（Claude など）で使用するには、クライアントの設定に次の内容を追加します：

{
  "mcpServers": {
    "flux-image-generator": {
      "command": "mcp-server-flux-image-generator",
      "env": {
        "BFL_API_KEY": "your_api_key_here"
      }
    }
  }
}

利用可能なツール

generateImage

設定をカスタマイズして、テキストプロンプトに基づいた画像を生成します。

パラメーター：

• prompt（文字列、必須）：生成する画像のテキストによる説明
• width（数値、任意、デフォルト：1024）：画像の幅（ピクセル単位）
• height（数値、任意、デフォルト：1024）：画像の高さ（ピクセル単位）
• promptUpsampling（ブール値、任意、デフォルト：false）：プロンプトをアップサンプリングして詳細を強化します
• seed（数値、任意）：結果を再現するための乱数シード
• safetyTolerance（数値、任意、デフォルト：3）：コンテンツモデレーションの許容度（1～5）

例：

{
  "prompt": "A serene lake at sunset with mountains in the background",
  "width": 1024,
  "height": 768,
  "promptUpsampling": true,
  "seed": 12345,
  "safetyTolerance": 3
}

quickImage

デフォルト設定ですばやく画像を生成する、簡易版のツールです。

パラメーター：

• prompt（文字列、必須）：生成する画像のテキストによる説明

例：

{
  "prompt": "A futuristic cityscape with flying cars"
}

batchGenerateImages

プロンプトのリストから複数の画像を生成します。

パラメーター：

• prompts（文字列の配列、必須）：テキストプロンプトのリスト（最大10件）
• width（数値、任意、デフォルト：1024）：画像の幅
• height（数値、任意、デフォルト：1024）：画像の高さ

例：

{
  "prompts": [
    "A serene lake at sunset",
    "A futuristic cityscape",
    "A magical forest with glowing plants"
  ],
  "width": 1024,
  "height": 768
}

出力形式

すべてのツールは、次の形式で応答を返します：

{
  "image_url": "https://storage.example.com/generated_image.jpg",
  "local_path": "/path/to/output/flux_1234567890.png"
}

エラーの場合：

{
  "error": true,
  "message": "Error description"
}

一括生成ツールは次の内容を返します：

{
  "total": 3,
  "successful": 2,
  "failed": 1,
  "results": [
    {
      "prompt": "A serene lake at sunset",
      "success": true,
      "image_url": "https://storage.example.com/image1.jpg",
      "local_path": "/path/to/output/flux_batch_1234567890_0.png"
    },
    {
      "prompt": "A futuristic cityscape",
      "success": true,
      "image_url": "https://storage.example.com/image2.jpg",
      "local_path": "/path/to/output/flux_batch_1234567890_1.png"
    },
    {
      "prompt": "Prohibited content",
      "success": false,
      "error": "Content policy violation"
    }
  ]
}

ライセンス

MIT