Pixel Surgeon MCP Server

AI image and video generation, editing, and region repair via Gemini, OpenAI, and Grok. Its 10 documented tools cover image, generate, fix, images. It runs locally over stdio via the published package.

People connecting media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-04 · ★ 5 · #104 OF 155 MAINTAINED MEDIA · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Pixel Surgeon

before you install - you'll need

Set GOOGLE_API_KEY, OPENAI_API_KEY, XAI_API_KEY before connecting.

Claude Code

claude mcp add j-east-pixel-surgeon-mcp -- npx -y pixel-surgeon-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "j-east-pixel-surgeon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixel-surgeon-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package pixel-surgeon-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.j-east is GitHub-verified and matches the repo owner

03 · What Pixel Surgeon can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can edit an existing image with natural language instructions, list generated images and videos, and remove image background (alpha channel transparency).

Capability map

Tools grouped from the project's README - what Pixel Surgeon lets an agent do.

Generate

3 tools - e.g. Text-to-image generation (single image); Parallel batch generation (1-8 images); Text-to-video via Veo 3 with audio (5s or 8s)

generate_image · generate_images · generate_video

Fix

3 tools - e.g. Grid-based tile repair for garbled text (2x2, 3x3, etc.); Targeted region repair with automatic aspect ratio snapping; Browser-based crop UI with multi-shot selection

fix_image · fix_region · interactive_fix

update

1 tool - e.g. Edit an existing image with natural language instructions

edit_image

read & search

1 tool - e.g. List generated images and videos

list_images

Save

1 tool - e.g. Import an external image into the workspace

save_image

delete

1 tool - e.g. Remove image background (alpha channel transparency)

remove_background

Latest releases

v1.1.1 · 2026-06-04

What's new in v1.1.0 → v1.1.1 · Grok Imagine provider (xAI) · New grok-imagine model - fastest and cheapest provider · Supports 7 aspect ratios at fixed ~1K resolution · Set XAI_API_KEY to enable · Style preset changes…

04 · Who maintains Pixel Surgeon

pixel-surgeon is maintained by j-east. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/j-east/pixel-surgeon-mcp
category: media - ranked #104 of 155 actively-maintained media servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-06-04)
registry: io.github.j-east/pixel-surgeon (active, first published 2026-05-22 · 3 versions)
packages: npm:pixel-surgeon-mcp

06 · Pixel Surgeon FAQ

Is Pixel Surgeon still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-04 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Pixel Surgeon do?

With this server connected, an agent can edit an existing image with natural language instructions, list generated images and videos, and remove image background (alpha channel transparency).

How do I install Pixel Surgeon?

Run `npx -y pixel-surgeon-mcp`. The README documents 3 environment variables (GOOGLE_API_KEY, OPENAI_API_KEY, XAI_API_KEY) to set first. Set GOOGLE_API_KEY, OPENAI_API_KEY, XAI_API_KEY before connecting. You can also paste the ready-made client config above.

Does Pixel Surgeon run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Pixel Surgeon

Alternatives to Pixel Surgeon

Maintained media servers if Pixel Surgeon isn't the fit.

More media MCP servers · Drawthings · Florence2 · Secondhand MCP · YTDL RMCP · Lacuna Music

More JavaScript MCP servers · Allmcps Server · Aigroup Mdtoword MCP · Cellarion · Fixgraph MCP · Dealflowpro · see all