Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client