Advertise
MCP.so
Sign In

Openai Gpt Image MCP Server

@SureScaleAI

Repository

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

SureScaleAI

About Openai Gpt Image MCP Server

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

Openai Gpt Image MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openai-gpt-image-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/dist/index.js"
      ],
      "env": {
        "OPENAI_API_KEY": ""
      }
    }
  }
}

Openai Gpt Image MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is openai-gpt-image-mcp?

openai-gpt-image-mcp is a Model Context Protocol (MCP) server that provides image generation and editing capabilities via OpenAI's GPT-4o and gpt-image-1 APIs. It is designed for developers and users of MCP-compatible clients such as Claude Desktop, Cursor, VSCode, and Windsurf.

How to use openai-gpt-image-mcp?

Clone the repository, install dependencies with yarn install, and build with yarn build. Then add a configuration entry to your MCP client (e.g., Claude Desktop or VSCode) specifying the path to dist/index.js and your OpenAI API key (or Azure credentials). The server exposes two tools: create-image (generate images) and edit-image (edit images with optional mask). Image output can be saved to disk or returned as base64.

Key features of openai-gpt-image-mcp

  • Generate images from text prompts with size, quality, and background options.
  • Edit images using inpainting, outpainting, or compositing with a mask.
  • Supports file paths and base64 input for source images and masks.
  • Automatic file output when total image size exceeds the 1MB MCP payload limit.
  • Works with OpenAI and Azure OpenAI deployments.
  • Configurable working directory via the MCP_HF_WORK_DIR environment variable.

Use cases of openai-gpt-image-mcp

  • Generate up to 10 images at once from a single prompt for creative projects.
  • Edit specific regions of an image by providing a mask and a new description.
  • Integrate AI image generation directly into AI‑assisted code editors or chat clients.
  • Produce images as files for use in documents, presentations, or web content.

Frequently asked questions

1

What dependencies are required to run openai-gpt-image-mcp?

You need Node.js, yarn (or npm), and an Internet connection. The server uses the OpenAI Node.js SDK and the MCP SDK.

2

How do I configure openai-gpt-image-mcp for Azure OpenAI?

Set the environment variables `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_ENDPOINT`, and `OPENAI_API_VERSION` in the MCP client configuration instead of `OPENAI_API_KEY`.

3

What happens if the generated image is larger than 1MB?

The tool automatically saves the image to disk and returns the file path instead of base64. This avoids the 1MB payload limit of MCP clients like Claude Desktop.

4

Where are files saved by default?

If no `file_output` path is specified, images are saved to `/tmp` (or the directory set by the `MCP_HF_WORK_DIR` environment variable) with a unique filename.

5

What file path format is required for input images?

Absolute paths are required. On Unix/macOS/Linux use a leading `/` (e.g., `/path/to/image.png`), and on Windows include the drive letter followed by `:` (e.g., `C:/path/to/image.png`).

Comments

More AI & Agents MCP servers

Sphere Marketplace

dtajitdinov-aris

Sphere is an exchange where AI agents list services and post requests for other agents. Registration is one request, free, with no human approval. The first order is free: sphere_receipt_trial, one per agent per 24 hours

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14

AskOne: Live Q&A and Polls

phuryn

Run free live audience Q&A and polls from your agent: start an AskOne room, add and launch a poll, approve or hide questions and mark them answered, close the room, then read the questions as a FAQ draft and get the resu

BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN

Official MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN

1

TruVerifAI Panel-review

TruVerifAI

TruVerifAI's Panel Review is the guardian agent for AI's highest-stakes coding decisions: four frontier models argue over an AI coding agent's riskiest designs, diffs, and commits before they execute, with local review g

1
Advertise