Skip to content
MCP server

Imagine MCP

MCP server for image/video understanding & generation (Gemini/OpenAI/Grok)

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.11.6
Listing updated
4 days ago

About Imagine MCP

Imagine MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add imagine-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' -- uvx imagine-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "imagine-mcp": {
      "command": "uvx",
      "args": [
        "imagine-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "imagine-mcp": {
      "command": "uvx",
      "args": [
        "imagine-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "imagine-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "imagine-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "imagine-mcp": {
      "command": "uvx",
      "args": [
        "imagine-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "imagine-mcp": {
      "command": "uvx",
      "args": [
        "imagine-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Configuration

  • UNDERSTAND_MODELSOrdered model chain for the understand path 'provider/model,...' (order = litellm fallback; provider inferred from the prefix). Empty = understand off (provider/tier catalog default). Generation stays provider/tier native.
  • GEMINI_API_KEYGoogle AI Studio API key (aistudio.google.com/apikey)
  • OPENAI_API_KEYOpenAI API key (platform.openai.com)
  • XAI_API_KEYxAI (Grok) API key (console.x.ai)
  • UNDERSTAND_MODELSOrdered model chain for the understand path 'provider/model,...' (order = litellm fallback; provider inferred from the prefix). Empty = understand off (provider/tier catalog default). Generation stays provider/tier native.
  • GEMINI_API_KEYGoogle AI Studio API key
  • OPENAI_API_KEYOpenAI API key
  • XAI_API_KEYxAI (Grok) API key

Pricing

Open source

Imagine MCP FAQ

Is Imagine MCP free?

Yes. Imagine MCP is open source, so you can use and self-host it for free.

How do I add Imagine MCP to Claude Code?

Run this command in your terminal: claude mcp add imagine-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' -- uvx imagine-mcp

What are the best alternatives to Imagine MCP?

The closest alternatives to Imagine MCP are HyperFrames by HeyGen, ffmpeg-skill, Claude Code Ultimate Guide, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

Alternatives to Imagine MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media