Which integrations are available for this server?

Utilizes the Flux model for high-quality AI image generation with support for detailed parameter customization. Provides integration with GitHub for project hosting and version control, with specific handling for API key protection in .gitignore. Supports installation and management of dependencies through npm, with specific commands for starting and developing the MCP server.

How do I use ModelsLab Text2Image MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ModelsLab Text2Image MCP Server generate a fantasy castle on a floating island at sunset using the flux model" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

🎨 ModelsLab Text2Image MCP Server [DRAFT]

⚠️ 注意: このプロジェクトは現在ドラフト版です。本番環境での使用前に十分なテストを行ってください。

ModelsLab APIを使用したText2Image画像生成専用のModel Context Protocol (MCP)サーバーです。Claude Codeから高品質なAI画像生成を簡単に実行できます。

🚀 主要機能

🎭 Fluxモデル標準搭載 - デフォルトで最新のFluxモデルを使用
🌈 複数モデル対応 - Flux、Stable Diffusion、Midjourney等をサポート
📁 ローカル保存 - 生成した画像をローカルファイルに自動保存
🔧 豊富な設定 - 画像サイズ、品質、スタイル等を細かく調整
🔒 セキュア - APIキーの安全な管理機能内蔵

Related MCP server: AI Development Pipeline MCP

📦 インストールと設定

1. リポジトリのクローン

git clone https://github.com/shimizu/modelslab-text2img-mcp-server.git
cd modelslab-text2img-mcp-server

2. 依存関係のインストール

npm install

3. ModelsLab API設定 🔑

📝 ModelsLabでアカウント作成
🆔 APIキーを取得
🔧 APIキーを設定:

# APIキー設定ファイルを作成
cp src/config/api-keys.example.js src/config/api-keys.js

# api-keys.jsを編集してAPIキーを設定
# apiKey: 'your_modelslab_api_key_here' を実際のキーに変更

重要: src/config/api-keys.js はGitHubにpushされません（.gitignoreで保護）

4. サーバー起動 ⚡

# MCPサーバーを起動
npm start

# MCP Inspectorで開発・テスト
npm run dev

Claude Code での使用

Claude Code では claude mcp add コマンドでMCPサーバーを登録します：

# プロジェクトに移動
cd /path/to/modelslab-text2img-mcp-server

# 実行権限を付与（初回のみ必要）
chmod +x src/index.js

# MCPサーバーを登録（ローカルスコープ）
claude mcp add modelslab-text2img node src/index.js

# または絶対パスで登録
claude mcp add modelslab-text2img node /path/to/modelslab-text2img-mcp-server/src/index.js

詳細は Claude Code MCP ドキュメントを参照してください。

使用開始

claudeを起動後/mcpコマンドを実行しMCPが正しく接続できているか確認してください。

✔ connectedが表示されていれば正常に動作しています。

💬 Claudeでの使用例

🎨 基本的な画像生成

美しい夕焼けの山景色の画像を生成してください

🎭 特定のモデルを指定

midjourney モデルを使用して、アニメスタイルのキャラクターポートレートを生成してください

🖼️ 複数画像の生成

「未来都市」をテーマに、2枚の画像を生成して保存してください

🔧 詳細設定での生成

以下の設定で画像を生成してください：
- プロンプト: "cyberpunk city at night, neon lights, rain"
- サイズ: 1024x768
- 品質: 高品質
- ネガティブプロンプト: "blurry, low quality"

🛠️ 利用可能なツール

🎨 modelslab_text2img

テキストプロンプトから高品質な画像を生成します

パラメータ:

prompt (string, required): 画像生成用のテキストプロンプト
model_id (string, optional): 使用するモデル（デフォルト: "flux"）
width (number, optional): 画像の幅（デフォルト: 512）
height (number, optional): 画像の高さ（デフォルト: 512）
samples (number, optional): 生成する画像数（デフォルト: 1）
negative_prompt (string, optional): ネガティブプロンプト
num_inference_steps (number, optional): 推論ステップ数（デフォルト: 20）
guidance_scale (number, optional): ガイダンススケール（デフォルト: 7.5）
outputPath (string, optional): 保存先ファイルパス
format (string, optional): 画像形式（jpg, png, webp等）

使用例:

{
  "prompt": "beautiful landscape at sunset",
  "model_id": "flux",
  "width": 1024,
  "height": 512,
  "samples": 1,
  "outputPath": "./generated_landscape.jpg"
}

👋 hello

動作確認用のシンプルなツール

🔗 test_connection

HTTP接続テスト用ツール

📋 レスポンス形式

🎨 画像生成結果（ファイル保存あり）

{
  "status": "success",
  "message": "画像をファイルに保存しました",
  "file": "./generated_image.jpg",
  "size": "245.67 KB",
  "contentType": "image/jpeg",
  "format": "jpg",
  "model": "flux",
  "prompt": "beautiful landscape at sunset",
  "dimensions": "1024x512",
  "samples": 1
}

🌐 画像生成結果（URLのみ）

{
  "success": true,
  "imageUrls": [
    "https://pub-3626123a908346a7a8be8d9295f44e26.r2.dev/generations/image1.jpg"
  ],
  "metadata": {
    "tool": "modelslab_text2img",
    "timestamp": "2024-01-01T12:00:00.000Z",
    "imageCount": 1,
    "model": "flux"
  }
}

🗂️ プロジェクト構造

📁 modelslab-text2img-mcp-server/
├── 📄 src/
│   ├── 🎯 index.js                    # エントリーポイント
│   ├── 🔌 adapters/                   # APIアダプター
│   │   └── 🎨 modelslab/
│   │       ├── ModelsLabClient.js     # ModelsLab APIクライアント
│   │       └── config.js              # API設定
│   ├── 🖥️ server/                     # MCPサーバー実装
│   │   ├── DataDownloadServer.js
│   │   └── config.js
│   ├── ⚙️ core/                       # 基底クラス
│   │   ├── DataSourceClient.js
│   │   └── ToolBase.js
│   ├── 🛠️ tools/                      # MCPツール
│   │   ├── index.js
│   │   ├── modelslab_text2img.js      # 画像生成ツール
│   │   ├── hello.js
│   │   └── test_connection.js
│   ├── 🔧 utils/                      # ユーティリティ
│   │   └── modelslab-image-handler.js # 画像処理
│   └── 📁 config/                     # 設定ファイル
│       └── api-keys.example.js        # APIキーテンプレート
├── 📖 docs/                           # ドキュメント
│   └── modelslab-text2img.md
├── 📦 package.json
├── 📖 README.md
└── 📝 CLAUDE.md

🌟 対応モデル

Flux - 最新の高品質画像生成モデル（デフォルト）
Stable Diffusion - 汎用的な画像生成モデル
Midjourney - アーティスティックな画像生成
その他 - ModelsLabでサポートされている全モデル

🚨 注意事項

🆔 APIキー必須: ModelsLab APIキーが必要です
🖼️ 画像制限: 最大サイズは1024x768または768x1024（メモリ制限）
📊 レート制限: APIの利用規約に従って適切な間隔でリクエストしてください
🔒 セキュリティ: src/config/api-keys.jsは絶対にコミットしないでください（.gitignoreで保護済み）

🆘 トラブルシューティング

APIキーエラー

ModelsLab API key is not configured

→ src/config/api-keys.jsファイルを確認してAPIキーが正しく設定されているか確認

画像生成エラー

The temp field must be true or false

→ パラメータの型が正しいかチェック。文字列ではなくbooleanを使用

接続エラー

timeout of 30000ms exceeded

→ ネットワーク接続とModelsLab APIサービス状況を確認

📄 ライセンス

MIT License

🤝 コントリビューション

Issues、Pull Requests大歓迎です！

Made with ❤️ for AI-powered Image Generation

ModelsLab Text2Image MCP Server