DALL-E MCP Server

DALL-E MCP サーバー

OpenAI の DALL-E API を使用して画像を生成する MCP（Model Context Protocol）サーバーです。

機能

• DALL-E 2 または DALL-E 3 を使用して画像を生成します
• 既存の画像を編集します（DALL-E 2 のみ）
• 既存の画像のバリエーションを作成します（DALL-E 2 のみ）
• OpenAI API キーを検証します

インストール

# Clone the repository
git clone https://github.com/Garoth/dalle-mcp.git
cd dalle-mcp

# Install dependencies
npm install

# Build the project
npm run build

Cline ユーザー向けの重要なお知らせ

この DALL-E MCP サーバーを Cline で使用する場合、saveDir パラメーターを現在の作業ディレクトリに設定し、生成した画像を現在のワークスペースディレクトリに保存することをおすすめします。これにより、Cline が生成された画像を会話内で正しく見つけて表示できます。

Cline での使用例：

{
  "prompt": "A tropical beach at sunset",
  "saveDir": "/path/to/current/workspace"
}

使用方法

サーバーの実行

# Run the server
node build/index.js

Cline の設定

VSCode の設定内にある Cline MCP 設定ファイル（例：~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）に dall-e サーバーを追加します：

{
  "mcpServers": {
    "dalle-mcp": {
      "command": "node",
      "args": ["/path/to/dalle-mcp-server/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "SAVE_DIR": "/path/to/save/directory"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

以下を確認してください：

1. /path/to/dalle-mcp-server/build/index.js を、ビルドした index.js ファイルの実際のパスに置き換えます
2. your-api-key-here を OpenAI API キーに置き換えます

利用可能なツール

generate_image

テキストプロンプトに基づいて DALL-E で画像を生成します。

{
  "prompt": "A futuristic city with flying cars and neon lights",
  "model": "dall-e-3",
  "size": "1024x1024",
  "quality": "standard",
  "style": "vivid",
  "n": 1,
  "saveDir": "/path/to/save/directory",
  "fileName": "futuristic-city"
}

パラメーター：

• prompt（必須）：生成する画像のテキストによる説明
• model（任意）：使用する DALL-E モデル（「dall-e-2」または「dall-e-3」、デフォルト：「dall-e-3」）
• size（任意）：生成する画像のサイズ（デフォルト：「1024x1024」）
  • DALL-E 3：「1024x1024」、「1792x1024」、または「1024x1792」
  • DALL-E 2：「256x256」、「512x512」、または「1024x1024」
• quality（任意）：生成する画像の品質。DALL-E 3 のみ（「standard」または「hd」、デフォルト：「standard」）
• style（任意）：生成する画像のスタイル。DALL-E 3 のみ（「vivid」または「natural」、デフォルト：「vivid」）
• n（任意）：生成する画像の数（1～10、デフォルト：1）
• saveDir（任意）：生成した画像の保存先ディレクトリ（デフォルト：現在のディレクトリ、または .env の SAVE_DIR）。**Cline ユーザー向け：**画像を正しく表示するため、現在のワークスペースディレクトリに設定することをおすすめします。
• fileName（任意）：生成した画像の拡張子を除いたベースファイル名（デフォルト：「dalle-{timestamp}」）

edit_image

テキストプロンプトに基づいて DALL-E で既存の画像を編集します。

⚠️ 既知の問題（2025年3月18日）： DALL-E 2 の画像編集 API には現在、適切な RGBA 形式の画像とマスクを使用していても、プロンプトを無視して編集を加えずに元の画像を返すことがある不具合があります。この問題は OpenAI コミュニティフォーラム に報告されています。この問題が発生した場合は、より安定して動作するように見える create_variation ツールをお試しください。

{
  "prompt": "Add a red hat",
  "imagePath": "/path/to/image.png",
  "mask": "/path/to/mask.png",
  "model": "dall-e-2",
  "size": "1024x1024",
  "n": 1,
  "saveDir": "/path/to/save/directory",
  "fileName": "edited-image"
}

パラメーター：

• prompt（必須）：加えたい編集内容のテキストによる説明
• imagePath（必須）：編集する画像のパス
• mask（任意）：マスク画像のパス（白い領域は編集され、黒い領域は保持されます）
• model（任意）：使用する DALL-E モデル（現在、編集に対応しているのは「dall-e-2」のみ。デフォルト：「dall-e-2」）
• size（任意）：生成する画像のサイズ（デフォルト：「1024x1024」）
• n（任意）：生成する画像の数（1～10、デフォルト：1）
• saveDir（任意）：編集した画像の保存先ディレクトリ（デフォルト：現在のディレクトリ、または .env の SAVE_DIR）。**Cline ユーザー向け：**画像を正しく表示するため、現在のワークスペースディレクトリに設定することをおすすめします。
• fileName（任意）：編集した画像の拡張子を除いたベースファイル名（デフォルト：「dalle-edit-{timestamp}」）

create_variation

DALL-E を使用して、既存の画像のバリエーションを作成します。

{
  "imagePath": "/path/to/image.png",
  "model": "dall-e-2",
  "size": "1024x1024",
  "n": 4,
  "saveDir": "/path/to/save/directory",
  "fileName": "image-variation"
}

パラメーター：

• imagePath（必須）：バリエーションを作成する画像のパス
• model（任意）：使用する DALL-E モデル（現在、バリエーションに対応しているのは "dall-e-2" のみです。デフォルト："dall-e-2"）
• size（任意）：生成する画像のサイズ（デフォルト："1024x1024"）
• n（任意）：生成するバリエーションの数（1～10、デフォルト：1）
• saveDir（任意）：バリエーション画像の保存先ディレクトリ（デフォルト：現在のディレクトリ、または .env の SAVE_DIR）。**Cline ユーザー向け：**画像を正しく表示するため、現在のワークスペースディレクトリに設定することをおすすめします。
• fileName（任意）：拡張子を除いたバリエーション画像のベースファイル名（デフォルト："dalle-variation-{timestamp}"）

validate_key

OpenAI API キーを検証します。

{}

パラメーターは不要です。

開発

テスト設定

注：以下の .env 設定はテストの実行にのみ必要で、通常の操作には必要ありません。

このプロジェクトを開発またはテストする場合は、ルートディレクトリに OpenAI API キーを記載した .env ファイルを作成してください。

# Required for TESTS ONLY: OpenAI API Key
OPENAI_API_KEY=your-api-key-here

# Optional: Default save directory for test images
# If not specified, images will be saved to the current directory
# SAVE_DIR=/path/to/save/directory

Cline で通常の操作を行う場合は、上記の「MCP 設定への追加」セクションで説明されているように、MCP 設定 JSON で API キーを設定してください。

API キーはOpenAI の API キーページから取得できます。

テストの実行

# Run basic tests
npm test

# Run all tests including edit and variation tests
npm run test:all

# Run tests in watch mode
npm run test:watch

# Run specific test by name
npm run test:name "should validate API key"

注：テストでは実際の API 呼び出しが行われるため、OpenAI アカウントに料金が発生する場合があります。

テスト画像の生成

このプロジェクトには、開発とテスト用のテスト画像を生成するスクリプトが含まれています。

# Generate a test image in the assets directory
npm run generate-test-image

これにより、assets ディレクトリにシンプルなテスト画像が作成され、編集機能とバリエーション機能のテストに使用できます。

ライセンス

MIT