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 配置仅用于运行测试，正常运行无需配置。

如果你正在开发此项目或运行其测试，请在根目录中创建一个 .env 文件，并填入你的 OpenAI API 密钥：

# 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 密钥。

你可以从 OpenAI API 密钥页面获取 API 密钥。

许可证

已更新为 HTTP 服务器 MCP。

原始代码库位于 https://github.com/Garoth/dalle-mcp