mcp-image

🥈Silver

MCP server for AI image generation and editing using Gemini 3 Pro Image Preview. Enables AI assistants to create and modify images. Integrates with Cursor, Codex, and other developer tools. Supports Claude agents.

10080Updated 1mo ago

Intermediate30min to implementautomation

Saves ~90 min per use

Quick InstallView Source

git clone https://github.com/shinpr/mcp-image.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"step":"Install and configure the mcp-image server in your development environment. Ensure it’s connected to your AI assistant (e.g., Cursor, Codex, or Claude).","tip":"Check the mcp-image documentation for setup instructions specific to your IDE. For Cursor, use the MCP sidebar to add the server."},{"step":"Prepare your image request by specifying either a generation or editing task. For generation, describe the image in detail. For editing, provide the source image path and adjustments.","tip":"Use descriptive prompts with style references (e.g., 'in the style of Studio Ghibli') and technical specs (e.g., resolution, aspect ratio) for better results."},{"step":"Send the request to the mcp-image server via your AI assistant. For example, in Cursor, use the MCP command `/mcp-image [your_prompt]` or integrate it into a custom agent workflow.","tip":"Break complex requests into smaller steps if the server supports incremental updates (e.g., generate base image first, then edit)."},{"step":"Review the output and iterate if needed. Use the server’s feedback to refine prompts or adjustments.","tip":"Save intermediate versions of edited images to avoid overwriting originals. Use version control (e.g., Git) for generated assets in collaborative projects."},{"step":"Integrate the final image into your workflow (e.g., save to a project folder, embed in documentation, or use in a design tool).","tip":"For developer tools like Codex, use the image URI returned by mcp-image to reference the file in your code or documentation."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/shinpr/mcp-image

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use the mcp-image server to generate or edit an image based on the following request: [DESCRIBE_IMAGE_REQUEST]. If editing, include the path to the source image: [SOURCE_IMAGE_PATH]. Specify any required adjustments like style, resolution, or modifications. For example: 'Generate a high-resolution cyberpunk cityscape in the style of Blade Runner, with neon lights and flying cars. Use mcp-image to create this image.'

Example Output

```json
{
  "image_generation_request": {
    "prompt": "A futuristic cyberpunk cityscape at night, towering skyscrapers with glowing neon signs in Japanese and English, dense urban sprawl with flying cars and holographic billboards, rain-soaked streets reflecting the neon lights, cinematic lighting with deep shadows and vibrant colors, ultra-high resolution, 8K quality",
    "style": "cyberpunk",
    "resolution": "8192x4320",
    "model": "gemini-3-pro-image-preview",
    "output_format": "png"
  },
  "image_editing_request": {
    "prompt": "Add a vintage 1980s filter with sepia tones, increase contrast by 20%, and overlay a subtle grid pattern in the background",
    "source_image_path": "/users/ai/desktop/photo.jpg",
    "adjustments": {
      "contrast": 20,
      "filter": "vintage-sepia",
      "overlay": "grid-pattern"
    }
  }
}
```

**Generated Image Details:**
- **Resolution:** 8192x4320 pixels (8K UHD)
- **Style:** Cyberpunk with neon aesthetics
- **Features:** Towering skyscrapers, flying cars, holographic billboards, rain-soaked streets with reflections
- **Color Palette:** Deep blues, purples, and vibrant neon accents (pink, cyan, yellow)
- **Lighting:** Cinematic with high contrast between shadows and bright neon lights

**Editing Example:**
For the vintage photo edit, the AI applied a sepia filter, boosted contrast to enhance details in the shadows, and added a subtle grid overlay to give it a retro-computer aesthetic. The original photo was a portrait of a 1980s office worker, now transformed into a nostalgic, high-contrast image with a tech-inspired background pattern.

**Output Location:**
- Generated images are saved to `/users/ai/outputs/[timestamp]_cyberpunk_cityscape.png`
- Edited images overwrite the source file unless specified otherwise.