media-gen-mcp
Media Gen MCP is a strict TypeScript Model Context Protocol (MCP) server for OpenAI Images (gpt-image-1.5, gpt-image-1), OpenAI Videos (Sora), and Google GenAI Videos (Veo): generate/edit images, create/remix video jobs, and fetch media from URLs or disk with smart resource_link vs inline image outputs and optional sharp processing. Production-focused (full strict typecheck, ESLint + Vitest CI). Works with fast-agent, Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, and any MCP-compatible client.
Design principle: spec-first, type-safe image tooling – strict OpenAI Images API + MCP compliance with fully static TypeScript types and flexible result placements/response formats for different clients.
- Generate images from text prompts using OpenAI's
gpt-image-1.5model (withgpt-image-1compatibility and DALL·E support planned in future versions). - Edit images (inpainting, outpainting, compositing) from 1 up to 16 images at once, with advanced prompt control.
- Generate videos via OpenAI Videos (
sora-2,sora-2-pro) with job create/remix/list/retrieve/delete and asset downloads. - Generate videos via Google GenAI (Veo) with operation polling and file-first downloads.
- Fetch & compress images from HTTP(S) URLs or local file paths with smart size/quality optimization.
- Fetch documents from HTTP(S) URLs or local file paths and return
resource_link/resourceoutputs. - Debug MCP output shapes with a
test-imagestool that mirrors production result placement (content,structuredContent,toplevel). - Integrates with: fast-agent, Windsurf, Claude Desktop, Cursor, VS Code, and any MCP-compatible client.
