openai-gpt-image-mcp

MCP.Pizza Chef: SureScaleAI

Two tools do the work: one makes a new picture from a written description, the other edits one you already have, optionally through a mask that marks the area to change. You bring your own paid OpenAI account and every picture is charged to it. Setup means downloading the code and building it yourself, because nothing is published ready-made. Saved files land wherever the assistant decides to put them and overwrite whatever was already there. Nothing has changed in this copy since May 2025.

Unmaintained ยท No commits in 16 months.
Images/Design

Use This MCP server To

Create a logo idea from a written description Remove an unwanted object from a photo I already have Extend a photo's background to fit a wider frame Generate several variations of one image at once Save a finished picture straight into a folder I name Make a transparent-background version of an illustration

README

openai-gpt-image-mcp

MCP SDK OpenAI SDK License GitHub stars Build Status


A Model Context Protocol (MCP) tool server for OpenAI's GPT-4o/gpt-image-1 image generation and editing APIs.

  • Generate images from text prompts using OpenAI's latest models.
  • Edit images (inpainting, outpainting, compositing) with advanced prompt control.
  • Supports: Claude Desktop, Cursor, VSCode, Windsurf, and any MCP-compatible client.

โœจ Features

  • create-image: Generate images from a prompt, with advanced options (size, quality, background, etc).
  • edit-image: Edit or extend images using a prompt and optional mask, supporting both file paths and base64 input.
  • File output: Save generated images directly to disk, or receive as base64.

๐Ÿš€ Installation

git clone https://github.com/SureScaleAI/openai-gpt-image-mcp.git
cd openai-gpt-image-mcp
yarn install
yarn build

๐Ÿ”‘ Configuration

Add to Claude Desktop or VSCode (including Cursor/Windsurf) config:

openai-gpt-image-mcp FAQ

Do I need to pay for anything?
Yes. You need an OpenAI account with credit on it, and the organisation has to be verified before the picture model will work at all. Verification can take fifteen to twenty minutes to take effect. Each picture is billed, and large high-quality ones cost noticeably more than small rough ones.
How hard is setup?
This is a developer job. There is no ready-made package to fetch, so you download the code, install its parts, build it, and then point your assistant at the built file.
Does it work with Microsoft's version of OpenAI?
Yes. If you supply Azure credentials instead of the standard ones, it switches over on its own with no other changes.
Where do my pictures end up?
Small ones come straight back into the chat. Anything over about one megabyte is saved to a file instead, silently, and unless you set a folder of your own it lands in your machine's temporary directory, where it may later be cleared away.
Can it overwrite my files?
Yes, and this is worth knowing. It writes to whichever full path is chosen at the time, with no confirmation and no check for a file already sitting there. Give it a scratch folder rather than a folder of work you care about.
Is it still maintained?
This copy is a fork of someone else's project and has not been touched since May 2025, so expect no updates as OpenAI's picture models change.
Can I use this to make product photos for a shop listing?
Yes, that is a good fit. Describe the product and the setting, or hand it a photo and describe the change you want.
Anything else I should know?
Two things. The strength of OpenAI's own content filter is offered as an ordinary setting, so the assistant can ask for it to be relaxed on any request. And the program writes a plain-text startup line onto the same channel it uses to talk to your assistant, which some apps report as a failure to start.