Skip to content
MCP server

Pixel Surgeon

AI image and video generation, editing, and region repair via Gemini, OpenAI, and Grok.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.1.1
Listing updated
5 days ago

About Pixel Surgeon

Pixel Surgeon 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 pixel-surgeon --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' -- npx -y pixel-surgeon-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pixel-surgeon": {
      "command": "npx",
      "args": [
        "-y",
        "pixel-surgeon-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pixel-surgeon": {
      "command": "npx",
      "args": [
        "-y",
        "pixel-surgeon-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "pixel-surgeon": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pixel-surgeon-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "pixel-surgeon": {
      "command": "npx",
      "args": [
        "-y",
        "pixel-surgeon-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<GOOGLE_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": {
    "pixel-surgeon": {
      "command": "npx",
      "args": [
        "-y",
        "pixel-surgeon-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "XAI_API_KEY": "<XAI_API_KEY>"
      }
    }
  }
}

Configuration

  • GOOGLE_API_KEYGoogle AI API key (enables Gemini image/video generation)
  • OPENAI_API_KEYOpenAI API key (enables GPT Image 1/2 generation)
  • XAI_API_KEYxAI API key (enables Grok Imagine generation)

Pricing

Open source

Pixel Surgeon FAQ

Is Pixel Surgeon free?

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

How do I add Pixel Surgeon to Claude Code?

Run this command in your terminal: claude mcp add pixel-surgeon --env GOOGLE_API_KEY='<GOOGLE_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env XAI_API_KEY='<XAI_API_KEY>' -- npx -y pixel-surgeon-mcp

What are the best alternatives to Pixel Surgeon?

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

Alternatives to Pixel Surgeon

  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