Pixel Surgeon MCP server
io.github.j-east/pixel-surgeon·v1.1.1·5 starsAI image and video generation, editing, and region repair via Gemini, OpenAI, and Grok.
5 stars
Reviews
Write oneNobody has reviewed Pixel Surgeon yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Pixel Surgeon tools (11, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
edit_imageEdit an existing image. Supports Gemini and OpenAI models — pass the model param to choose. Provide the filename of an image in … (use list_images to see available files, or save_image to import one first). The MCP reads the file directly — do NOT pass base64 image data.
fix_imageFix an image that has glitched or garbled text by splitting it into tiles, re-rendering each tile, and stitching them back together. This works because smaller sections have less text for the model to handle at once. Use this when a generated image has text artifacts or overloaded text regions.
fix_regionFix a specific region of an image by cropping it out, sending it for repair, and reinserting it. The crop is automatically snapped to the nearest supported aspect ratio. Use this when only part of an image has glitched text or artifacts — more precise than fix_image's grid approach.
generate_imageGenerate a single image. Supports Gemini and OpenAI models — pass the model param to choose. Full-resolution image is viewable in the browser viewer.
generate_imagesGenerate multiple images in parallel. Supports Gemini and OpenAI models — pass the model param to choose. Returns the generated images and any accompanying text. Full-resolution images are viewable in the browser viewer.
generate_videoGenerate a video using Google's Veo 3. Returns an MP4 video file. Video generation takes 1-3 minutes — the tool will poll until complete. Veo 3 generates both video and ambient audio. Videos are saved to the shared directory and viewable in the browser viewer.
interactive_fixOpens an image in a browser-based crop tool where the user can draw a rectangle around the region to fix, add notes/instructions, and submit. The tool waits for the user's selection, then sends the cropped region for repair and composites it back into the original image. Best for precise, user-guided fixes.
list_imagesList image and video files in the shared pixel-surgeon directory (…). Use this to find images available for editing.
remove_backgroundwrite actionRemove a background color from an image and make it transparent. Outputs a PNG with alpha channel. The image must already exist in … (use save_image to import first).
save_imageCopy an image file into the shared pixel-surgeon directory (…) so it can be used with edit_image. Use this when the user wants to edit an image that exists elsewhere on their filesystem.
trace_to_svgConvert a raster image to SVG using potrace vectorization. Best for line art, diagrams, logos, and high-contrast images. The image must already exist in … (use save_image to import first).
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan3 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 115 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Pixel Surgeon compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 40% of 4,460 AI and agents servers
- Tools
- 11
- the typical AI and agents server has 6
- Tools that change things
- 9%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 5
- more than 78% of 2,711 AI and agents servers
What its tools let an agent do: 5 read · 4 create · 1 change · 1 delete
Install Pixel Surgeon in Claude Code, Cursor or VS Code
Runs npx -y pixel-surgeon-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add pixel-surgeon -- npx -y pixel-surgeon-mcp
What the publisher says
From the Pixel Surgeon repository's README, as published. We do not edit it. Read it on GitHub
pixel-surgeon-mcp
MCP server for AI image & video generation, editing, and transplant-grade region repair Powered by Gemini 3.1 Flash Image, OpenAI GPT Image 2, Grok Imagine, and Veo 3
An MCP server that gives Claude (or any MCP client) the ability to generate images, edit them, fix garbled text, and create videos — all through natural language.
How it works
pixel-surgeon-mcp is a multi-provider image generation server. You can use any combination of providers and switch between them per-request:
Gemini (Google) — balanced
Google's image generation pipeline uses a two-stage approach: Gemini 3.1 Pro reasons about your prompt, then Gemini 3.1 Flash Image renders the pixels. Supports 9 aspect ratios at 512/1K/2K/4K resolution. Best price/performance ratio, with a free tier available.
OpenAI GPT Image 2 — highest quality
OpenAI's latest image model with dramatically improved text rendering and visual fidelity. Supports flexible resolutions — pixel-surgeon maps your chosen size and aspect ratio to the optimal pixel dimensions automatically. Quality levels: medium (fast) and high (print-ready). Excellent for infographics, diagrams, and text-heavy images where other models struggle. Slower and more expensive.
Grok Imagine (xAI) — fastest
xAI's Aurora-powered image model. Fastest generation speed and lowest cost. Supports 7 aspect ratios at fixed resolutions (~1K). Good for rapid prototyping and iteration.
Veo 3 (Video)
For video, the server calls Veo 3 with async polling — generating both video and ambient audio. Supports 16:9 and 9:16 at 5s or 8s duration.
Region repair
AI image models struggle with text-heavy images. The fix tools solve this by sending smaller regions to the provider, then stitching the results back with histogram-matched compositing for seamless blending.
Tools
Models
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Pixel Surgeon: common questions
- Is Pixel Surgeon MCP server safe?
- Mostly: it is graded B (72/100). Read the Pixel Surgeon safety report
- How do I install Pixel Surgeon?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Pixel Surgeon need an API key?
- Yes. The registry entry asks for
GOOGLE_API_KEY,OPENAI_API_KEY,XAI_API_KEY. - Is Pixel Surgeon maintained?
- The last commit was 153 days ago (2026-06-04). The latest release is v1.1.1.
- What can I use instead of Pixel Surgeon?
- Servers from other publishers that do the same job: Image MCP server, Agent-Native Assets MCP server and WaveSpeed MCP server.
- How does Pixel Surgeon compare with other AI and agents MCP servers?
- safety score 72/100 (higher than 40% of 4,460 AI and agents servers); tools 11 (the typical AI and agents server has 6); tools that change things 9% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Pixel Surgeon
Same job from other publishers: the closest match first, then the best rated.
- ImageAI image generation and editing with prompt optimization and quality presetsnot reviewedEstablishedB
- Agent-Native AssetsDigital asset manager - upload, organize, search, and generate on-brand images and videosnot reviewedEstablishedA
- WaveSpeedRun any model on the live WaveSpeed catalog: image, video, audio, 3D.not reviewedEstablishedA
GuaardvarkLocal AI studio on your GPU: images, video, music, voice, RAG. Needs the Guaardvark app installed.not reviewedEstablishedB- Runapi130+ AI models for image, video, music, and audio — 18 model families, one RunAPI account.not reviewedEstablishedA