openai-images-mcp

Model Context Protocol 도구로 노출되는 OpenAI의 gpt-image 및 DALL·E 모델을 사용하여 이미지를 생성하고 편집하세요. gpt-image-1.5, gpt-image-1, gpt-image-1-mini, dall-e-3, dall-e-2를 지원합니다.

도구

생성된 모든 파일은 디스크에 저장됩니다. 호출 시 return_image_content: true를 설정하면 MCP 이미지 블록으로도 이미지를 받을 수 있습니다(클라이언트가 결과를 "확인"해야 할 때 유용하지만, 토큰을 많이 소모합니다).

설치

npm install
npm run build

MCP 클라이언트 구성

Claude Desktop / Claude Code

claude_desktop_config.json(또는 프로젝트의 .mcp.json)에 추가하세요:

{
  "mcpServers": {
    "dalle": {
      "command": "node",
      "args": ["/absolute/path/to/dalle-mcp/dist/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-...",
        "DALLE_OUTPUT_DIR": "/absolute/path/where/images/save"
      }
    }
  }
}

환경 변수

도구 참조

generate_image

필수: prompt.

선택 사항: model, size, quality, n, background, output_format, output_compression, moderation, style, user, output_dir, filename_prefix, return_image_content.

모델별 참고 사항:

• GPT Image (gpt-image-1.5, gpt-image-1, gpt-image-1-mini): 크기 auto|1024x1024|1536x1024|1024x1536, 품질 auto|low|medium|high. background, output_format, output_compression, moderation을 지원합니다.

• DALL·E 3: 크기 1024x1024|1792x1024|1024x1792, 품질 standard|hd, n은 1이어야 하며, style을 지원합니다.

• DALL·E 2: 크기 256x256|512x512|1024x1024, 품질 standard.

edit_image

필수: prompt, images (절대 경로, GPT Image의 경우 최대 16개).

선택 사항: mask (투명 픽셀은 편집 가능한 영역을 나타냄), 위에서 언급한 생성 옵션. DALL·E 3는 편집을 지원하지 않습니다.

create_variation

DALL·E 2 전용. 필수: image (PNG, 정사각형, 4MB 미만).

선택 사항: n, size (256x256|512x512|1024x1024), output_dir, filename_prefix, return_image_content.

list_models

인수 없음. 각 모델의 크기, 품질 및 지원되는 옵션을 설명하는 JSON 문서를 반환합니다. 매개변수를 선택하기 전에 호출자가 확인하기에 유용합니다.

개발

npm run dev     # run with tsx, no build step
npm run build   # tsc to dist/
npm start       # node dist/index.js

서버는 stdio를 통해 MCP를 통신하므로, 모든 MCP 호환 클라이언트로 구동하거나 node dist/index.js로 JSON-RPC 메시지를 파이핑하여 수동으로 구동할 수 있습니다.

참고 사항

• DALL·E 2와 DALL·E 3는 OpenAI에 의해 지원이 중단되었으며 지원은 2026-05-12에 종료됩니다. GPT Image 제품군을 사용하는 것을 권장합니다.

• GPT Image 모델은 항상 base64 데이터를 반환합니다. DALL·E 모델도 두 번째 HTTP 왕복 없이 파일을 저장할 수 있도록 base64를 요청합니다.