Flux Image Generator

🚀 FLUX画像生成器MCPサーバ

このサーバは、Black Forest LabのFLUXモデルを使用して画像を生成するためのMCP（モデルコンテキストプロトコル）サーバです。最新のMCP SDK（v1.7.0）を採用しています。

🚀 クイックスタート

このサーバは、Black Forest LabのFLUXモデルを用いて、テキストプロンプトに基づいた画像生成を行います。Node.js環境で動作し、APIキーを必要とします。

✨ 主な機能

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

📦 インストール

ソースコードからのインストール

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": " sunset中的一片宁静湖水，背景是群山",
  "width": 1024,
  "height": 768,
  "promptUpsampling": true,
  "seed": 12345,
  "safetyTolerance": 3
}

quickImage

デフォルト設定を使用して、画像を迅速に生成する簡易ツールです。 パラメータ：

• prompt（文字列、必須）：画像を説明するテキスト

例：

{
  "prompt": "具有飞行汽车的未来城市景观"
}

batchGenerateImages

プロンプトのリストに基づいて、複数の画像を一括で生成します。 パラメータ：

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

例：

{
  "prompts": [
    " sunset中的一片宁静湖水，背景是群山",
    "未来城市景观中的飞行汽车",
    " prohibited content"
  ],
  "width": 1024,
  "height": 768
}

📚 ドキュメント

出力形式

成功レスポンス

{
  "images": [
    {
      "path": "/generated-images/1.png",
      "status": "success"
    },
    {
      "path": "/generated-images/2.png",
      // 他の画像情報...
    }
  ]
}