Content
# MCP OpenAI Image Generator
MCP server that wraps OpenAI's `gpt-image-2` image generation API.
## Tools
| Tool | Description |
|------|-------------|
| `generate_image` | Generate images from text prompts using gpt-image-2 |
| `list_generated_images` | List all previously generated images in the output folder |
| `load_image` | Load and display a saved image inline |
## Setup
### 1. Build
```bash
npm install
npm run build
```
### 2. Configuration
Environment variables:
| Variable | Default | Description |
|----------|---------|-------------|
| `OPENAI_API_KEY` | *(required)* | Your OpenAI API key |
| `OPENAI_BASE_URL` | *(optional)* | Custom base URL (e.g. a self-hosted proxy); defaults to official OpenAI endpoint |
| `IMAGE_OUTPUT_DIR` | `./generated_images` | Where to save generated images |
### 3. Register with Claude Desktop / Kiro CLI
Add to your MCP config (e.g. `~/.claude/mcp.json` or Claude Desktop `claude_desktop_config.json`):
```json
{
"mcpServers": {
"openai-image": {
"command": "node",
"args": ["D:/project/fully_async/mcp-openai-image/dist/index.js"],
"env": {
"OPENAI_API_KEY": "your-openai-api-key",
"IMAGE_OUTPUT_DIR": "D:/project/fully_async/mcp-openai-image/generated_images"
}
}
}
}
```
## Usage Examples
### Architecture diagram
```
generate_image(
prompt = "AWS microservices architecture diagram: React SPA → API Gateway → 3 Lambda functions (auth, orders, products) → DynamoDB + S3. Clean white background, blue/orange color scheme, connected with arrows, professional tech style.",
size = "1536x1024",
quality = "high"
)
```
### System design
```
generate_image(
prompt = "System design diagram for a real-time chat application: WebSocket servers, Redis pub/sub, message queue (Kafka), PostgreSQL, CDN for media. Dark background, neon connectors, modern style.",
size = "1536x1024",
quality = "medium"
)
```
## Supported Parameters
| Parameter | Options | Default |
|-----------|---------|---------|
| `size` | `1024x1024`, `1024x1536`, `1536x1024`, `auto` | `1024x1024` |
| `quality` | `low`, `medium`, `high`, `auto` | `medium` |
| `n` | 1–4 | `1` |
| `output_format` | `png`, `jpeg`, `webp` | `png` |
| `save_to_disk` | `true` / `false` | `true` |
| `output_dir` | any path | `./generated_images` |
