create_image: Generate new images from text prompts

create_image_edit: Edit existing images with text prompts and masks

🚀 Key Benefits

Simple integration with MCP clients
Full access to OpenAI's gpt-image-1 capabilities
Streamlined workflow for AI image generation

### 💡 Enhanced Capabilities

📊 Output & Formatting

✅ Beautifully Formatted Output: Responses include emojis and detailed information
✅ Automatic Image Saving: All generated images saved to disk for easy access
✅ Detailed Token Usage: View token consumption for each request

⚙️ Configuration & Handling

✅ Configurable Output Directory: Customize where images are saved
✅ File Path Support: Edit images using file paths instead of base64 encoding
✅ Comprehensive Error Handling: Detailed error reporting with specific error codes, descriptions, and troubleshooting suggestions

## 🔄 How It Works

🖼️ Image Generation	✏️ Image Editing
Server receives prompt and parameters Calls OpenAI API using gpt-image-1 model API returns base64-encoded images Server saves images to configured directory Returns formatted response with paths and metadata	Server receives image, prompt, and optional mask For file paths, reads and prepares files for API Uses direct curl command for proper MIME handling API returns base64-encoded edited images Server saves images to configured directory Returns formatted response with paths and metadata

### 📁 Output Directory Behavior

📂 Storage Location

🔹 Default Location: User's Pictures folder under gpt-image-1 subfolder (e.g., C:\Users\username\Pictures\gpt-image-1 on Windows)
🔹 Custom Location: Set via GPT_IMAGE_OUTPUT_DIR environment variable
🔹 Fallback Location: ./generated-images (if Pictures folder can't be determined)

🗂️ File Management

🔹 Directory Creation: Automatically creates output directory if it doesn't exist
🔹 File Naming: Images saved with timestamped filenames (e.g., image-2023-05-05T12-34-56-789Z.png)
🔹 Cross-Platform: Works on Windows, macOS, and Linux with appropriate Pictures folder detection

## Installation & Usage ### NPM Package This package is available on npm: [@cloudwerxlab/gpt-image-1-mcp](https://www.npmjs.com/package/@cloudwerxlab/gpt-image-1-mcp) You can install it globally: ```bash npm install -g @cloudwerxlab/gpt-image-1-mcp ``` Or run it directly with npx as shown in the Quick Start section. ### Tool: `create_image` Generates a new image based on a text prompt. #### Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `prompt` | s

#gpt-image-1

@cloudwerxlab/gpt-image-1-mcp