Aiimagemultistyle

MCP 画像生成ツール

fal.ai の Stable Diffusion モデルを使用して画像を生成・編集する Model Context Protocol（MCP）サーバーです。

機能

• テキストプロンプトから高品質な画像を生成
• 複数のアニメ・アートスタイルに対応：
  • ジブリ風
  • Pixar 風
  • Pokemon 風
  • Genshin Impact 風
  • サイバーパンク風
  • One Piece 風
  • Attack on Titan 風
  • 新海誠風
  • Sailor Moon 風
  • Evangelion 風
  • Disney Princess 風
  • Kyoto Animation 風
  • Dreamworks Animation 風
  • Marvel Studios 風
  • DC Comics 風
  • かわいいパステル風
  • Simpsons 風
  • Dragon Ball 風
  • Demon Slayer 風
  • Warner Bros Animation 風
  • ダークファンタジー風
  • ほかにも多数の日本のアニメスタイルに対応
• 複数の画像サイズを選択可能：
  • 正方形（512x512）
  • 正方形 HD（1024x1024）
  • 縦長 4:3（768x1024）
  • 縦長 16:9（576x1024）
  • 横長 4:3（1024x768）
  • 横長 16:9（1024x576）
• 1 回のリクエストで複数の画像を生成（最大 4 枚）
• 画像のアップスケーリング（解像度を 4 倍に拡張）
• 画像の検索・置換機能
• NSFW コンテンツの検出機能を内蔵

インストール

1. リポジトリをクローンします：

git clone [repository-url]
cd aiimagemultistyle

2. 依存関係をインストールします：

npm install

3. 環境変数を設定します： 次の内容で .env ファイルを作成します：

FALAI_API_KEY=your_fal_ai_key_here

使用方法

MCP サーバーの設定

MCP Image Generator サーバーを使用するには、mcpServers の設定に追加します：

{
  "mcpServers": {
    "image-generator": {
      "command": "npx",
      "args": ["-y", "aiimagemultistyle"]
    }
  }
}

追加の設定オプションも指定できます：

{
  "mcpServers": {
    "image-generator": {
      "command": "npx",
      "args": [
        "-y",
        "aiimagemultistyle",
        "--mode=rest",
        "--port=9593",
        "--endpoint=/rest"
      ],
      "env": {
        "FALAI_API_KEY": "your_fal_ai_key_here"
      }
    }
  }
}

サーバーの起動

サーバーは次の 2 つのモードで実行できます：

1. STDIO モード（デフォルト）：

npm start

2. REST モード：

npm start -- --mode=rest --port=9593 --endpoint=/rest

API リファレンス

画像の生成

リクエスト形式：

{
  "name": "generate_image",
  "arguments": {
    "prompt": "A beautiful sunset over mountains",
    "style": "ghibli-style",
    "num_images": 1,
    "size": "square_hd"
  }
}

パラメーター：

• prompt（必須）：生成する画像のテキストによる説明
• style（任意）：画像のスタイル（デフォルト："ghibli-style"）
  • 使用可能なスタイル：一覧は上記の「機能」セクションを参照してください
• num_images（任意）：生成する画像の数（1～4、デフォルト：1）
• size（任意）：画像サイズ（デフォルト："square_hd"）
  • 使用可能なサイズ："square"、"square_hd"、"portrait_4_3"、"portrait_16_9"、"landscape_4_3"、"landscape_16_9"

画像のアップスケーリング

リクエスト形式：

{
  "name": "upscale_image",
  "arguments": {
    "image_url": "https://example.com/image.jpg"
  }
}

パラメーター：

• image_url（必須）：アップスケーリングする画像の URL

検索と置換

リクエスト形式：

{
  "name": "search-and-replace",
  "arguments": {
    "image_url": "https://example.com/image.jpg",
    "mask_url": "https://example.com/mask.jpg",
    "prompt": "Description of the replacement"
  }
}

パラメーター：

• image_url（必須）：編集する画像の URL
• mask_url（必須）：マスク画像の URL（黒い領域は保持され、白い領域はインペイントされます）
• prompt（必須）：置き換える内容の説明

開発

• npm run build：プロジェクトをビルドします
• npm run watch：開発用の監視モードを実行します
• npm run inspector：MCP inspector を実行します

エラー処理

サーバーは、一般的な問題について詳細なエラーメッセージを表示します：

• API キーがない
• プロンプトが無効
• スタイルまたはサイズのパラメーターが無効
• API リクエストの失敗
• NSFW コンテンツの検出

ライセンス

MIT