返回 MCP 目录
public公开dns本地运行

DALL-E

一个基于OpenAI DALL-E API的MCP服务器,提供图像生成、编辑和变体功能,支持与Cline集成。

article

README

🚀 DALL-E MCP 服务器

DALL-E MCP 服务器是一款基于 OpenAI 的 DALL-E AI 模型的图像工具,可用于生成、编辑和操作图像。它支持创建新图像、编辑现有图像以及生成图像变体,为图像创作提供了便捷的解决方案。

🚀 快速开始

DALL-E MCP 服务器基于 OpenAI 的 DALL-E AI 模型,能帮助你轻松完成图像的生成、编辑和操作。下面为你介绍使用前的准备工作。

✨ 主要特性

  • 创建新图像:通过文本描述即可生成高质量图像。
  • 编辑图像:对现有图像进行修改(当前仅限于 DALL-E 2)。
  • 生成变体:根据现有图像生成多个变体。
  • 验证 API 密钥:确认 OpenAI API 访问令牌的有效性。

📦 安装指南

  1. 克隆此仓库到本地。
  2. 运行以下命令安装依赖:
    npm install
    
  3. 根据需要配置环境变量 .env 文件。

💻 使用示例

安装指南

在根目录下创建一个 .env 文件,并添加以下内容(根据实际需求调整):

# 必须的:OpenAI API 密钥
OPENAI_API_KEY=your-api-key-here

# 可选:默认保存图像的位置
SAVE_DIR=/path/to/save/images

操作指南

基础用法

创建新图像
{
  "prompt": "一只飞翔的蓝鸟",
  "model": "dall-e-2",
  "size": "1024x1024",
  "n": 3,
  "saveDir": "/path/to/save/images",
  "fileName": "bluebird-fly"
}

参数解释:

  • prompt:必填,生成图像的描述。
  • model:可选,默认为 dall-e-2
  • size:可选,默认为 1024x1024
  • n:可选,默认为 1。

高级用法

编辑图像
{
  "prompt": "添加一个红色的帽子",
  "imagePath": "/path/to/image.png",
  "mask": "/path/to/mask.png",
  "model": "dall-e-2",
  "size": "1024x1024",
  "n": 1,
  "saveDir": "/path/to/save/images",
  "fileName": "edited-image"
}

参数解释:

  • prompt:必填,描述需要的修改。
  • imagePath:必填,要编辑的图像路径。
  • mask:可选,默认为无。
创建变体
{
  "imagePath": "/path/to/image.png",
  "model": "dall-e-2",
  "size": "1024x1024",
  "n": 4,
  "saveDir": "/path/to/save/images",
  "fileName": "image-variation"
}

参数解释:

  • imagePath:必填,要生成变体的图像路径。
  • model:可选,默认为 dall-e-2
验证 API 密钥
{}

无需要的参数。

📚 详细文档

开发与测试

测试配置

注意:以下 .env 配置仅用于测试,正常运行时不需此文件。

在根目录下创建一个 .env 文件,并添加:

# 必须用于测试:OpenAI API 密钥
OPENAI_API_KEY=your-api-key-here

# 可选:默认保存路径
SAVE_DIR=/path/to/save/images

测试运行

  1. 启动服务器:
    npm start
    
  2. 使用 postman 或其他工具发送 POST 请求到 http://localhost:3000/api/process

⚠️ 注意事项

⚠️ 重要提示

确保 .env 文件中的路径正确,避免权限问题。

💡 使用建议

测试时请使用合法的 API 密钥,并注意费用限制。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端