Log inSubmit server
Pixel Surgeon MCP logo

Pixel Surgeon MCP

by j-east

Generate and edit images, create Veo 3 videos, repair regions, remove backgrounds, and trace raster art to SVG over MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Pixel Surgeon MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "j-east-pixel-surgeon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pixel-surgeon-mcp"
      ],
      "env": {
        "GOOGLE_API_KEY": "YOUR_VALUE_HERE",
        "OPENAI_API_KEY": "YOUR_VALUE_HERE",
        "XAI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

j-east/pixel-surgeon-mcp MCP server gives MCP clients tools for generating and editing images, creating Veo 3 videos, and repairing image regions. It stores workspace files in ~/Pictures/pixel-surgeon and uses provider API keys for Google, OpenAI, and xAI models. Use it when an agent needs image creation, text-artifact repair, background removal, or raster-to-SVG conversion. The stdio server can run through npx, while interactive_fix opens a browser crop interface for user-guided repairs.

Use cases

  • Generate batches of concept images for comparison
  • Edit an existing image with natural-language instructions
  • Repair garbled text in generated artwork
  • Remove a solid background and export a transparent PNG
  • Convert high-contrast raster artwork into SVG

Key features

  • Multi-provider image generation
  • Veo 3 video generation with ambient audio
  • Grid and region-based image repair
  • Browser-guided crop repair
  • Background removal with alpha transparency
  • Raster-to-SVG tracing

Tools11

What Pixel Surgeon MCP lets your agent do. Expand a tool for its parameters.

Verified live~4.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · pixel-surgeon-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads211Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Tools exposed11Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Pixel Surgeon MCP works

What j-east/pixel-surgeon-mcp MCP server does

j-east/pixel-surgeon-mcp MCP server exposes image and video workflows through MCP tools. It can generate one image or a parallel batch, edit an existing workspace image from natural-language instructions, create a Veo 3 video, and repair visual defects. Additional utilities import files into the workspace, list available media, remove a background color with transparency, and convert raster artwork to SVG.

The repair tools target different levels of precision. fix_image divides an image into tiles, re-renders the tiles, and stitches them together to address garbled text or broader artifacts. fix_region crops a selected area and reinserts the repaired result. interactive_fix opens a browser crop tool so a person can select the exact region and add repair instructions.

How it works

j-east/pixel-surgeon-mcp MCP server uses a multi-provider model setup. Image generation and editing can use Google Gemini or OpenAI image models, with a model parameter available for choosing a model. Video generation uses Google Veo 3 and polls until the MP4 is ready; the result includes ambient audio and is saved in the shared directory.

Crops are adjusted to the nearest supported aspect ratio before repair. Repaired regions are composited with histogram matching to normalize RGB channels. Full-resolution outputs remain on disk, while smaller versions can be returned in MCP responses to stay within MCP message-size limits. Generated media can be viewed through the local browser viewer.

Setup and configuration

Run the package without a local installation:

Terminal
npx pixel-surgeon-mcp

At least one provider API key is needed. The supported environment variables are GOOGLE_API_KEY, OPENAI_API_KEY, and XAI_API_KEY; supply the keys for the providers you plan to use. Google credentials cover Gemini and Veo 3, OpenAI credentials cover GPT Image models, and xAI credentials cover Grok Imagine.

Claude Code can register the server with claude mcp add and environment variables. Claude Desktop and other MCP clients can start it with the npx command and an MCP server configuration. A source-based setup is also available by cloning the repository, running npm install, and building with npm run build.

Images and videos are stored in ~/Pictures/pixel-surgeon/. To edit or process a file elsewhere, call save_image first. list_images shows media already available in that directory.

Tools and capabilities

The j-east/pixel-surgeon-mcp MCP server provides these operations:

  • generate_image creates one image.
  • generate_images creates multiple images in parallel.
  • generate_video creates a 5- or 8-second Veo 3 video.
  • edit_image applies natural-language changes to a workspace image.
  • fix_image, fix_region, and interactive_fix repair text artifacts or other damaged areas.
  • list_images and save_image manage workspace files.
  • remove_background outputs a transparent PNG after removing a background color.
  • trace_to_svg vectorizes suitable raster art with potrace.

Generation and editing tools support optional style presets, including neo-brutalist, duval-software-infographic, fractal-arcade, and clean-tech-infographic.

Limitations and notes

Video generation can take one to three minutes because the server waits for Veo 3 to finish. Veo 3 supports 16:9 and 9:16 output at 5 or 8 seconds. Grok Imagine uses fixed, approximately 1K resolutions, while Gemini and OpenAI models provide different resolution options.

The Google free-tier fallback uses Gemini 2.5 Flash Image after certain billing or prepayment failures, but it is limited to 1K resolution, 10 requests per minute, and 500 requests per day. Google Gemini 3.1 Flash Image and Veo 3 require billing and prepaid credits. Files passed to edit_image, remove_background, and trace_to_svg must already exist in the shared directory; do not pass base64 data to edit_image.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pixel Surgeon MCP

j-east/pixel-surgeon-mcp is an MCP server that connects AI clients to Google Gemini, OpenAI image models, xAI Grok Imagine, and Veo 3. Its main tools generate and edit images, create videos, repair damaged regions, remove backgrounds, list or import workspace files, and trace raster artwork to SVG.

Run `npx pixel-surgeon-mcp` to start it without installing the package locally. Configure one or more provider API keys in the MCP client environment. You can also clone the repository, run `npm install`, build with `npm run build`, and start the compiled server.

Provide at least one provider key: `GOOGLE_API_KEY`, `OPENAI_API_KEY`, or `XAI_API_KEY`. Google covers Gemini and Veo 3, OpenAI covers GPT Image models, and xAI covers Grok Imagine. You can provide multiple keys to switch providers.

Use `fix_image` for tile-based repair across the image, or `fix_region` for a targeted crop. Use `interactive_fix` when a person should draw the repair area in a browser and add notes before the server composites the result.

Yes, it works with Claude Desktop through a standard stdio MCP configuration. Start it with `npx pixel-surgeon-mcp`, add the provider keys under the server's `env` object, and configure the command and package arguments.

Related MCP servers

All in Art & Culture All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPixel Surgeon MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/j-east-pixel-surgeon-mcp?style=directory)](https://allmcps.com/mcp/j-east-pixel-surgeon-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/j-east-pixel-surgeon-mcp"><img src="https://allmcps.com/api/badge/j-east-pixel-surgeon-mcp?style=directory" alt="Pixel Surgeon MCP on AllMCPs" /></a>