# media-gen-mcp

Creates and edits pictures using OpenAI models, and generates videos with Sora or Google Veo straight from your coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Author: strato-space
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/strato-space/media-gen-mcp
- Updated: 2026-01-30
- HTML: https://affpapa.org/en/nevibecode/mcp/media-gen-mcp

## What it does

This server connects coding assistants to OpenAI media APIs and Google Veo. It exposes tools for generating visuals with `gpt-image-1.5`, altering up to 16 pictures at once, and dispatching video rendering jobs via `sora-2` or Google Veo.

The server handles long-running jobs, tracking their status until completion. It downloads finished `.mp4` clips, preview thumbnails, and spritesheets directly to local storage, passing outputs back as MCP `resource_link` references or embedded blocks.

Calls will fail immediately without valid credentials like `OPENAI_API_KEY` or `GEMINI_API_KEY` passed into the environment.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `OPENAI_API_KEY`, `GEMINI_API_KEY`, `GOOGLE_API_KEY`, `GOOGLE_GENAI_USE_VERTEXAI`, `GOOGLE_CLOUD_PROJECT`, `GOOGLE_CLOUD_LOCATION`, `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_ENDPOINT`, `OPENAI_API_VERSION`, `AZURE_OPENAI_DEPLOYMENT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GOOGLE_API_KEY=<GOOGLE_API_KEY> --env GOOGLE_GENAI_USE_VERTEXAI=<GOOGLE_GENAI_USE_VERTEXAI> --env GOOGLE_CLOUD_PROJECT=<GOOGLE_CLOUD_PROJECT> --transport stdio media-gen-mcp -- npx -y @strato-space/media-gen-mcp
```
Replace <…> with your own values. 9 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add media-gen-mcp --env OPENAI_API_KEY=<OPENAI_API_KEY> --env GEMINI_API_KEY=<GEMINI_API_KEY> --env GOOGLE_API_KEY=<GOOGLE_API_KEY> --env GOOGLE_GENAI_USE_VERTEXAI=<GOOGLE_GENAI_USE_VERTEXAI> --env GOOGLE_CLOUD_PROJECT=<GOOGLE_CLOUD_PROJECT> -- npx -y @strato-space/media-gen-mcp
```
Replace <…> with your own values. 9 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "media-gen-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@strato-space/media-gen-mcp"
            ],
            "env": {
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "GEMINI_API_KEY": "<GEMINI_API_KEY>",
                "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
                "GOOGLE_GENAI_USE_VERTEXAI": "<GOOGLE_GENAI_USE_VERTEXAI>",
                "GOOGLE_CLOUD_PROJECT": "<GOOGLE_CLOUD_PROJECT>"
            }
        }
    }
}
```
Replace <…> with your own values. 9 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "media-gen-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@strato-space/media-gen-mcp"
            ],
            "env": {
                "OPENAI_API_KEY": "<OPENAI_API_KEY>",
                "GEMINI_API_KEY": "<GEMINI_API_KEY>",
                "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
                "GOOGLE_GENAI_USE_VERTEXAI": "<GOOGLE_GENAI_USE_VERTEXAI>",
                "GOOGLE_CLOUD_PROJECT": "<GOOGLE_CLOUD_PROJECT>"
            }
        }
    }
}
```
Replace <…> with your own values. 9 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GEMINI_API_KEY=<GEMINI_API_KEY> -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e GOOGLE_GENAI_USE_VERTEXAI=<GOOGLE_GENAI_USE_VERTEXAI> -e GOOGLE_CLOUD_PROJECT=<GOOGLE_CLOUD_PROJECT> media-gen-mcp npx -y @strato-space/media-gen-mcp
```
Replace <…> with your own values. 9 more environment variables are in the server README

## When to use it
- render images from descriptive prompts using `gpt-image-1.5`
- composite and edit up to 16 picture files with inpainting masks
- submit and poll video rendering jobs in Sora or Google Veo
- save generated `.mp4` video files and thumbnails to local storage

## Example prompts
- Generate a concept art image of an abandoned space station using `openai-images-generate`
- Apply inpainting to `banner.png` to remove the background logo
- Start a video render of ocean waves at sunset using Veo and save the resulting `.mp4` file

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26673
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9298

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md