1. Conduid
  2. Content
  3. openai-images-mcp
MCP server · Content

openai-images-mcp

by · github.com/sam-david/openai-images-mcp

An MCP server for generating and editing images using OpenAI's GPT Image and DALL·E models. It provides tools for image generation, editing, variation creation, and model listing with support for multiple AI models.

Unclaimed last commit 6 months ago content
InstallView source
34Low

Scored 6 months ago · breakdown

About openai-images-mcp

openai-images-mcp is an MCP server published by sam-david in the Content category: an MCP server for generating and editing images using OpenAI's GPT Image and DALL·E models. It provides tools for image generation, editing, variation creation, and model listing with support for multiple AI models.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/sam-david/openai-images-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (4)

create_variationGenerate variations of an image.

Parameters not published.

edit_imageEdit existing images with a prompt and optional mask.

Parameters not published.

generate_imageGenerate one or more images from a text prompt.

Parameters not published.

list_modelsList supported models and their capabilities (sizes, qualities, edit/variation support).

Parameters not published.

Ask AI

✦

Ask AI about openai-images-mcp

Powered by Claude · Grounded in docs

I know everything about openai-images-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

openai-images-mcp

Generate and edit images with OpenAI's gpt-image and DALL·E models, exposed as Model Context Protocol tools. Supports gpt-image-1.5, gpt-image-1, gpt-image-1-mini, dall-e-3, and dall-e-2.

Tools

Tool Purpose Models
list_models List supported models and their capabilities (sizes, qualities, edit/variation support). all
generate_image Generate one or more images from a text prompt. gpt-image-1.5, gpt-image-1, gpt-image-1-mini, dall-e-3, dall-e-2
edit_image Edit existing images with a prompt and optional mask. gpt-image-1.5, gpt-image-1, gpt-image-1-mini, dall-e-2
create_variation Generate variations of an image. dall-e-2 only

All generated files are saved to disk. Set return_image_content: true on any call to also receive the images as MCP image blocks (useful when the client should "see" the result, but adds a lot of tokens).

Install

npm install
npm run build

Configure your MCP client

Claude Desktop / Claude Code

Add to claude_desktop_config.json (or your project's .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"
      }
    }
  }
}

Environment variables

Variable Purpose
OPENAI_API_KEY Required. Your OpenAI API key.
OPENAI_BASE_URL Optional. Override OpenAI base URL.
OPENAI_ORG_ID Optional.
OPENAI_PROJECT_ID Optional.
DALLE_OUTPUT_DIR Optional. Default directory for saved images. Falls back to ~/dalle-mcp-output.
DALLE_DEFAULT_MODEL Optional. Model used when a tool call omits model. Default gpt-image-1.5.

Tool reference

generate_image

Required: prompt.

Optional: model, size, quality, n, background, output_format, output_compression, moderation, style, user, output_dir, filename_prefix, return_image_content.

Model-specific notes:

  • GPT Image (gpt-image-1.5, gpt-image-1, gpt-image-1-mini): sizes auto|1024x1024|1536x1024|1024x1536, qualities auto|low|medium|high. Supports background, output_format, output_compression, moderation.
  • DALL·E 3: sizes 1024x1024|1792x1024|1024x1792, qualities standard|hd, n must be 1, supports style.
  • DALL·E 2: sizes 256x256|512x512|1024x1024, quality standard.

edit_image

Required: prompt, images (absolute paths, up to 16 for GPT Image).

Optional: mask (transparent pixels indicate editable regions), plus the generation options above. DALL·E 3 does not support edits.

create_variation

DALL·E 2 only. Required: image (PNG, square, under 4MB).

Optional: n, size (256x256|512x512|1024x1024), output_dir, filename_prefix, return_image_content.

list_models

No arguments. Returns a JSON document describing each model's sizes, qualities, and supported options — handy for the caller to consult before picking parameters.

Development

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

The server speaks MCP over stdio, so you can drive it with any MCP-compatible client or manually by piping JSON-RPC messages to node dist/index.js.

Notes

  • DALL·E 2 and DALL·E 3 are deprecated by OpenAI and support ends 2026-05-12; prefer the GPT Image family.
  • GPT Image models always return base64 data; DALL·E models are asked for base64 as well so files can be saved without a second HTTP round-trip.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About openai-images-mcp

How do I install openai-images-mcp?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is openai-images-mcp safe to use with an AI agent?

Its trust score is 34 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is openai-images-mcp still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.