DALL-E MCP 服务器

简介

DALL-E MCP 服务器是一个用于生成、编辑和操作图像的工具，基于 OpenAI 的 DALL-E 模型。它支持以下功能：

1. 图像生成：根据文本描述生成高质量图像。
2. 图像编辑：对现有图像进行特定区域的编辑。
3. 图像变体：生成与原图风格一致但内容不同的变体图像。
4. 密钥验证：验证 OpenAI API 密钥的有效性。

安装指南

克隆仓库

使用 Git 克隆此仓库：

git clone your-repository-url
cd dall-e-mcp-server

安装依赖

运行以下命令安装项目所需的依赖项：

npm install

构建项目

构建项目以生成生产文件：

npm run build

Cline 用户的重要提示

在将此服务器集成到 Cline 时，请确保按照以下步骤配置 OpenAI API 密钥：

1. 在 Cline 的 MCP 设置 JSON 文件中，添加 openai_api_key 字段，并设置为您自己的密钥。
2. 确保服务器具有读取和写入权限，以便正确处理图像文件。

功能模块

1. 图像生成

根据文本描述生成图像。例如：

{
  "prompt": "一只飞翔的猫头鹰",
  "model": "dall-e-3",
  "width": 512,
  "height": 512,
  "save_dir": "/path/to/save/images"
}

2. 图像编辑

对现有图像进行特定区域的编辑。例如：

{
  "prompt": "在图片中间添加一个红色爱心",
  "image_path": "/path/to/image.jpg",
  "mask_path": "/path/to/mask.png",
  "model": "dall-e-2"
}

3. 图像变体

生成与原图风格一致的变体图像。例如：

{
  "image_path": "/path/to/image.jpg",
  "num_variations": 4,
  "size": "1024x1024"
}

4. 密钥验证

验证 OpenAI API 密钥的有效性：

{}

开发部分

测试配置

注意：以下 .env 配置仅用于测试环境，而非生产环境。

在项目的根目录创建一个 .env 文件，并添加以下内容：

OPENAI_API_KEY=your-api-key-here
SAVE_DIR=/path/to/save/images

运行测试

运行基本测试：

npm test

运行所有测试（包括编辑和变体测试）：

npm run test:all

在监视模式下运行测试：

npm run test:watch

指定名称运行特定测试：

npm run test:name "should validate API key"

生成测试图像

项目提供一个脚本来生成用于开发和测试的测试图像：

npm run generate-test-image

许可证

本项目使用 MIT 许可证。