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.

Tool	Provider	Default model
openai_generate_image	OpenAI Images API	gpt-image-2
gemini_generate_image	Gemini (Nano Banana)	gemini-2.5-flash-image
gemini_generate_video	Veo via Gemini API	veo-3.1-generate-001

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.

Quick install (one command)

Run this — it installs everything, asks for your two API keys, and registers the tools in both Claude Code and the Claude desktop app:

bash <(curl -fsSL https://raw.githubusercontent.com/eracom-technologies/image-video-mcp/main/setup.sh)

That's it. Restart the Claude desktop app when it finishes, and the image/video tools are ready in both places. (Prefer to set keys inline? OPENAI_API_KEY=sk-... GEMINI_API_KEY=... bash <(curl -fsSL .../setup.sh).)

The manual steps below are only if you'd rather do it yourself.

Manual 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 ..

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.