# pixel-surgeon

Генерирует и редактирует картинки или видео прямо в чате с агентом через модели Google, OpenAI и xAI. Помогает перерисовывать фрагменты с битым текстом и убирать фон.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: j-east
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/j-east/pixel-surgeon-mcp
- Обновлён: 2026-06-04
- HTML: https://affpapa.org/nevibecode/mcp/pixel-surgeon

## Что делает

Сервер связывает агентские среды с генераторами медиафайлов от трёх провайдеров. Для быстрой черновой работы подходит Grok Imagine. Если на иллюстрации нужны точные надписи или схемы, запросы направляются в OpenAI `gpt-image-2`. Генерация видео со звуком идёт через Google Veo 3 длительностью 5 или 8 секунд.

Отдельный блок инструментов исправляет дефекты нейросетевых картинок. Инструмент `fix_image` делит изображение на сетку тайлов, чтобы заново отрендерить нечитаемый текст, а `fix_region` точечно перерисовывает выбранный фрагмент с подгонкой гистограмм. Для генерации также предусмотрены готовые стили, включая `neo-brutalist` и `duval-software-infographic`.

Для запуска нужен хотя бы один ключ: `GOOGLE_API_KEY`, `OPENAI_API_KEY` или `XAI_API_KEY`. Модели Gemini 3.1 Flash Image и Veo 3 требуют предоплаченного счёта в Google AI Studio. Если на балансе Google закончатся средства, сервер переключится на бесплатную модель `gemini-2.5-flash-image` с лимитом разрешения 1K.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GOOGLE_API_KEY`, `OPENAI_API_KEY`, `XAI_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex 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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e XAI_API_KEY=<XAI_API_KEY> pixel-surgeon npx -y pixel-surgeon-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- генерировать иллюстрации и инфографику с чётким текстом через GPT Image 2
- исправлять испорченные надписи на сгенерированных изображениях по сетке тайлов
- создавать короткие видеоролики со звуком на 5 или 8 секунд через Veo 3
- удалять фон у готовых изображений с добавлением прозрачности

## Примеры запросов агенту
- Сгенерируй инфографику архитектуры сервиса в стиле clean-tech-infographic через модель gpt-image-2
- Исправь смазанный текст на этой картинке с помощью инструмента fix_image
- Создай вертикальное видео 9:16 длительностью 5 секунд по этому описанию через Veo 3

## Похожие
- [Next AI Draw.io](https://affpapa.org/nevibecode/mcp/next-ai-drawio.md) — MCP-сервер · ★ 36427
- [tldraw](https://affpapa.org/nevibecode/mcp/tldraw.md) — MCP-сервер · ★ 51104
- [Figma-Context-MCP](https://affpapa.org/nevibecode/mcp/figma-context-mcp.md) — MCP-сервер · ★ 16073
- [Agent-Native Assets](https://affpapa.org/nevibecode/mcp/agent-native-assets.md) — MCP-сервер · ★ 7527
- [Remove AI Watermarks](https://affpapa.org/nevibecode/mcp/remove-ai-watermarks.md) — MCP-сервер · ★ 6144
- [Dembrandt](https://affpapa.org/nevibecode/mcp/dembrandt.md) — MCP-сервер · ★ 3851

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
