OpenAI GPT Image
About
Generate and edit images using OpenAI's GPT-4o image generation and editing APIs with advanced prompt control.
Details
- Author
- 199-biotechnologies
- Categories
- Developer Tools, AI, Other
- Tags
- #content-creation
Jump to
Setup
Install OpenAI GPT Image in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/199-biotechnologies/mcp-openai-image
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) tool server for OpenAI's GPT-4o/gpt-image-1 image generation and editing APIs.
- Generate imagesfrom 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.
- 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.
- Aspect Ratio Support: Use common aspect ratios like 16:9, 9:16, 1:1, landscape, portrait, etc., which automatically map to supported sizes.
- File output: Save generated images directly to disk, or receive as base64.
- AI-Generated Filenames: The AI can provide descriptive filenames like "cat-playing-football.jpg" based on the image content.
No installation needed! Use directly with npx:
{ "mcpServers": { "openai-gpt-image": { "command": "npx", "args": ["openai-gpt-image-mcp-199bio"], "env": { "OPENAI_API_KEY": "sk-..." } } } }
npm install -g openai-gpt-image-mcp-199bio
git clone https://github.com/199-biotechnologies/openai-gpt-image-mcp.git cd openai-gpt-image-mcp yarn install yarn build
The configuration shown above in the Quick Setup section works for all MCP-compatible clients:
Just add the configuration to your MCP client's config file with your OpenAI API key.
The tools now support common aspect ratios that automatically map to OpenAI's supported sizes:
- Square:1:1,square,4:3,3:4→ 1024x1024
- Landscape:16:9,landscape,3:2→ 1536x1024
- Portrait:9:16,portrait,2:3→ 1024x1536
- Auto:auto→ Let OpenAI choose the best size
Example: Instead of specifyingsize: "1536x1024", you can usesize: "16:9"orsize: "landscape".
- Forcreate-image, setnto generate up to 10 images at once.
- Foredit-image, provide a mask image (file path or base64) to control where edits are applied.
- Seesrc/index.tsfor all options.
- TypeScript source:src/index.ts
- Build:yarn build
- Run:node dist/index.js
- Make sure yourOPENAI_API_KEYis valid and has image API access.
- You must have averified OpenAI organization. After verifying, it can take 15–20 minutes for image API access to activate.
- File paths must be absolute.
- Unix/macOS/Linux: Starting with/(e.g.,/path/to/image.png)
- Windows: Drive letter followed by:(e.g.,C:/path/to/image.pngorC:\path\to\image.png)
⚠️ Limitations & Large File Handling
- 1MB Payload Limit:MCP clients (including Claude Desktop) have a hard 1MB limit for tool responses. Large images (especially high-res or multiple images) can easily exceed this limit if returned as base64.
- Auto-Switch to File Output:If the total image size exceeds 1MB, the tool will automatically save images to disk and return the file path(s) instead of base64. This ensures compatibility and prevents errors likeresult exceeds maximum length of 1048576.
- Default File Location:
- macOS/Linux: Images are saved to~/Pictures/gpt-image/by default
- Fallback: If the default directory cannot be created, images will be saved to/tmp(or the directory set by theMCP_HF_WORK_DIRenvironment variable)
- Custom Path: You can always specify a customfile_outputpath to override the default
- The AI can provide descriptive filenames through thefilenameparameter (e.g., "cat-playing-football", "sunset-over-mountains")
- Filenames are automatically sanitized to prevent security issues
- If multiple images are generated, an index is appended (e.g., "cat-playing-football_1.jpg", "cat-playing-football_2.jpg")
- MCP_HF_WORK_DIR: Set this to control the fallback directory for large images and file outputs. Example:export MCP_HF_WORK_DIR=/your/desired/dir
- Built with@modelcontextprotocol/sdk
- UsesopenaiNode.js SDK
- Built bySureScale.ai
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Generate images using Amazon Nova Canvas with text prompts and color guidance.
Server for advanced AI-driven video editing, semantic search, multilingual transcription, generative media, voice cloning, and content moderation.
Generate images using the Together AI API. Supports custom aspect ratios, save paths, and batch generation.
Trim, watermark, extract audio from, and convert any video to 9:16 vertical — via REST API or MCP tools for Claude, Cursor, and other AI agents.
Generate images using OpenAI's DALL-E API.
Generate images from text using Flux and Stable Diffusion models.
Integrates the Dify AI API to generate Ant Design business component code. Supports text, image inputs, and streaming responses.
A server for the Fal.ai text-to-image API, powered by OpenAI's image model. Requires Fal.ai and OpenAI API keys.
Advanced text-to-image generation using the fal.ai Recraft v3 API.
A frontier image generation and editing model with advanced text rendering and contextual understanding, powered by the FAL AI API.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
