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 访问令牌的有效性。
📦 安装指南
- 克隆此仓库到本地。
- 运行以下命令安装依赖:
npm install - 根据需要配置环境变量
.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
测试运行
- 启动服务器:
npm start - 使用
postman或其他工具发送 POST 请求到http://localhost:3000/api/process。
⚠️ 注意事项
⚠️ 重要提示
确保
.env文件中的路径正确,避免权限问题。💡 使用建议
测试时请使用合法的 API 密钥,并注意费用限制。
扫码联系在线客服