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 키 검증
Related MCP server: Image Generator MCP Server
설치
지엑스피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.jsCline 구성
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-hereOpenAI 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/directoryCline을 정상적으로 작동시키려면 위의 "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