Pixel Surgeon MCP Server

by j-eastio.github.j-east/pixel-surgeonv1.1.1

Image and video generation, editing and region repair via Gemini 3.1 Flash Image, GPT Image 2, Grok Imagine and Veo 3, with style presets.

5Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install Pixel Surgeon MCP server

claude mcp add pixel-surgeon -e GOOGLE_API_KEY='<google-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e XAI_API_KEY='<xai-api-key>' -- npx -y pixel-surgeon-mcp

{
  "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 (global) or .cursor/mcp.json (project).

{
  "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>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "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 .vscode/mcp.json in your workspace.

{
  "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 ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_API_KEY	—	yes	Google AI API key (enables Gemini image/video generation)
OPENAI_API_KEY	—	yes	OpenAI API key (enables GPT Image 1/2 generation)
XAI_API_KEY	—	yes	xAI API key (enables Grok Imagine generation)

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-05-27 · 5mo ago · GitHub
Latest release
2026-06-04 · 4mo ago · GitHub · v1.1.1
Package published
no data · npm/PyPI
Registry entry updated
2026-05-26 · 5mo ago · official registry · v1.1.1

FAQ

›How do I install the Pixel Surgeon MCP server in Claude Code?

Run: claude mcp add pixel-surgeon -e GOOGLE_API_KEY='<google-api-key>' -e OPENAI_API_KEY='<openai-api-key>' -e XAI_API_KEY='<xai-api-key>' -- npx -y pixel-surgeon-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Pixel Surgeon require an API key?

Yes. It expects GOOGLE_API_KEY, OPENAI_API_KEY, XAI_API_KEY, of which 3 are secrets.

›Can I use Pixel Surgeon as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Pixel Surgeon in the official MCP registry?

Yes, as io.github.j-east/pixel-surgeon.