DALL-E MCP Server running on port

ポートで実行する 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/oybekdevuz/dalle-mcp.git
cd dalle-mcp

# Install dependencies
npm install

# Build the project
npm run build

使用方法

サーバーの実行

# Run the server
npm start

Cline ユーザー向けの重要な注意事項

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

Cline での使用例：

{
  "prompt": "A tropical beach at sunset",
  "saveDir": "/path/to/where-want-to/save/image"
}

Cline の設定

import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
import { McpName } from "src/enum/McpName";

async function setupClient() {
  let client: any = undefined;
  const baseUrl: any = "http://127.0.0.1:3002/mcp";

  try {
    client = new Client({
      name: 'streamable-http-client',
      version: '1.0.0'
    });
    const transport = new StreamableHTTPClientTransport(new URL(baseUrl) as any);
    await client.connect(transport);
    console.log("Connected using Streamable HTTP transport");
  } catch (error) {
    console.log("Streamable HTTP connection failed, falling back to SSE transport");
    client = new Client({
      name: 'dalle-image-generator',
      version: '1.0.0'
    });
    const sseTransport = new SSEClientTransport(baseUrl);
    await client.connect(sseTransport);
    console.log("Connected using SSE transport");
  }
}

setupClient()

以下を必ず行ってください。

1. your-api-key-here を OpenAI API キーに置き換えます。

使用可能なツール

generate_image

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

{
  "prompt": "A futuristic city with flying cars and neon lights",
  "saveDir": "/path/to/save/directory",
}

パラメーター：

• 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" または "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 キーページで取得できます。

ライセンス

HTTP サーバー MCP に更新されました。

元のリポジトリは https://github.com/Garoth/dalle-mcp です。