pixel-surgeon — MCP-сервер для Claude Code
Генерирует и редактирует картинки или видео прямо в чате с агентом через модели Google, OpenAI и xAI. Помогает перерисовывать фрагменты с битым текстом и убирать фон.
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Что делает 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.
Какие задачи решает
- генерировать иллюстрации и инфографику с чётким текстом через GPT Image 2
- исправлять испорченные надписи на сгенерированных изображениях по сетке тайлов
- создавать короткие видеоролики со звуком на 5 или 8 секунд через Veo 3
- удалять фон у готовых изображений с добавлением прозрачности
Примеры запросов агенту
- Сгенерируй инфографику архитектуры сервиса в стиле clean-tech-infographic через модель gpt-image-2
- Исправь смазанный текст на этой картинке с помощью инструмента fix_image
- Создай вертикальное видео 9:16 длительностью 5 секунд по этому описанию через Veo 3
Как установить pixel-surgeon
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"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>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о pixel-surgeon
Как установить pixel-surgeon в Claude Code?
Выполните команду `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`. Достаточно передать ключ хотя бы одного провайдера.
Что делает MCP-сервер pixel-surgeon?
Он даёт агенту инструменты для создания изображений, генерации видео через Veo 3 и попиксельного исправления дефектов нейросетей. В него также встроены стили оформления и удаление фона.
Что произойдёт, если закончатся средства на балансе Google AI Studio?
При ошибке биллинга сервер автоматически переведёт вызовы на бесплатную модель gemini-2.5-flash-image. У неё действует ограничение разрешения до 1K и лимит в 10 запросов в минуту.
