image-video-mcp

One MCP server that adds OpenAI image generation and Google Gemini image + video generation to Claude Code — and any MCP client. Bring your own API keys.

Images save to assets/images/, videos to assets/videos/. Every model is overridable with an env var, so it keeps working as models roll over.

Install

One-line, straight from git:

pip install "git+https://github.com/eracom-technologies/image-video-mcp.git"

Or from a local clone:

git clone https://github.com/eracom-technologies/image-video-mcp.git
cd image-video-mcp && pip install .

Both create the image-video-mcp command. Prefer isolation? pipx install . or uv tool install ..

Related MCP server: mcp-media-engine

Register in Claude Code

claude mcp add-json image-video '{
  "command": "image-video-mcp",
  "args": [],
  "env": { "OPENAI_API_KEY": "sk-...", "GEMINI_API_KEY": "..." }
}'
claude mcp list          # confirm it shows "image-video"

Or drop the included .mcp.json into a project folder (Claude Code auto-detects it). Get keys at platform.openai.com and aistudio.google.com/apikey.

Use

Ask Claude Code:

"Use gemini_generate_video: a slow drone shot over a misty forest, 16:9."

Verify

PYTHONPATH=src python scripts/smoke_test.py          # offline: tools register
PYTHONPATH=src python scripts/smoke_test.py --live   # real generations (uses credits)

Full docs

See README-MCP.md for OS-specific config locations, all environment variables, model/deprecation notes, sharing, and troubleshooting.

License

MIT — see LICENSE.