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 키 검증

설치

지엑스피1

클라인 사용자를 위한 중요 참고 사항

Cline과 함께 이 DALL-E MCP 서버를 사용할 경우, saveDir 매개변수를 현재 작업 디렉터리와 동일하게 설정하여 생성된 이미지를 현재 작업 공간 디렉터리에 저장하는 것이 좋습니다. 이렇게 하면 Cline이 생성된 이미지를 대화에서 제대로 찾아 표시할 수 있습니다.

Cline의 사용 예:

{
  "prompt": "A tropical beach at sunset",
  "saveDir": "/path/to/current/workspace"
}

용법

서버 실행

# Run the server
node build/index.js

Cline 구성

VSCode 설정 내의 Cline MCP 설정 파일에 dall-e 서버를 추가합니다(예: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "dalle-mcp": {
      "command": "node",
      "args": ["/path/to/dalle-mcp-server/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "your-api-key-here",
        "SAVE_DIR": "/path/to/save/directory"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

다음 사항을 확인하세요.

/path/to/dalle-mcp-server/build/index.js 빌드된 index.js 파일의 실제 경로로 바꾸세요.
your-api-key-here OpenAI API 키로 바꾸세요.

사용 가능한 도구

생성_이미지

DALL-E를 사용하여 텍스트 프롬프트를 기반으로 이미지를 생성합니다.

{
  "prompt": "A futuristic city with flying cars and neon lights",
  "model": "dall-e-3",
  "size": "1024x1024",
  "quality": "standard",
  "style": "vivid",
  "n": 1,
  "saveDir": "/path/to/save/directory",
  "fileName": "futuristic-city"
}

매개변수:

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", "512x512" 또는 "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}")

이미지 편집

텍스트 프롬프트를 기반으로 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}")

변형 생성

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}")

유효성 검사 키

OpenAI API 키를 검증합니다.

{}

매개변수가 필요하지 않습니다.

개발

테스트 구성

참고: 다음 .env 구성은 일반적인 작업이 아닌 테스트 실행에만 필요합니다.

이 프로젝트에 대한 테스트를 개발하거나 실행하려면 OpenAI API 키와 함께 루트 디렉토리에 .env 파일을 만드세요.

# 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 키를 얻을 수 있습니다.

테스트 실행

# Run basic tests
npm test

# Run all tests including edit and variation tests
npm run test:all

# Run tests in watch mode
npm run test:watch

# Run specific test by name
npm run test:name "should validate API key"

참고: 테스트에서는 실제 API 호출을 사용하므로 OpenAI 계정에 요금이 부과될 수 있습니다.

테스트 이미지 생성

이 프로젝트에는 개발 및 테스트를 위한 테스트 이미지를 생성하는 스크립트가 포함되어 있습니다.

# Generate a test image in the assets directory
npm run generate-test-image

이렇게 하면 편집 및 변형 기능을 테스트하는 데 사용할 수 있는 간단한 테스트 이미지가 assets 디렉토리에 생성됩니다.

특허

MIT

DALL-E MCP Server

Integrations

DALL-E MCP 서버

특징

설치

클라인 사용자를 위한 중요 참고 사항

용법

서버 실행

Cline 구성

사용 가능한 도구

생성_이미지

이미지 편집

변형 생성

유효성 검사 키

개발

테스트 구성

테스트 실행

테스트 이미지 생성

특허