# PixelForge

MCP-сервер PixelForge для Claude Code создаёт пиксельные спрайты и игровые изображения через Google Gemini. Запросите анимацию, фон, тайлсет или обработку PNG.

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

## Что делает

PixelForge генерирует пиксельные спрайты, кадры анимации, фоны, миниатюры и тайлсеты, а также обрабатывает готовые PNG. Можно удалить фон, обрезать изображение, уменьшить его до пиксельного разрешения или разделить спрайт-лист на отдельные кадры. Для обработки используйте `process_sprite`, для уменьшения изображения — `optimize_sprite`.

Для генерации нужны Node.js версии 20 или выше и ключ Google Gemini API в переменной `GEMINI_API_KEY`. Сервер запускается через `npx`; готовые изображения сохраняются по заданным путям. Референсные спрайты можно передать для совпадения визуального стиля.

Инструмент `forge_item_kit` создаёт набор до 16 связанных спрайтов и разделяет его на отдельные PNG. Для ярко-зелёных объектов нельзя выбирать `chromakey`: фильтр может удалить зелёные части самого спрайта.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add pixelforge-mcp -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add pixelforge --env GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y pixelforge-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pixelforge": {
            "command": "npx",
            "args": [
                "-y",
                "pixelforge-mcp"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "pixelforge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "pixelforge-mcp"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

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

## Когда брать
- создать пиксельный спрайт с удалённым фоном
- разделить спрайт-лист на отдельные PNG-кадры
- сгенерировать кадры анимации в едином стиле
- собрать тайлсет для пола или стен
- уменьшить крупное изображение до пиксельного разрешения

## Примеры запросов агенту
- Создай пиксельный спрайт рыцаря и сохрани его в `assets/knight.png`.
- Сделай анимацию прыжка слизи на 4 кадра.
- Раздели `assets/spritesheet.png` на отдельные кадры.

## Похожие
- [layer-pixel-art](https://affpapa.org/nevibecode/skills/layer-pixel-art.md) — скилл · 5100 установок
- [game-assets](https://affpapa.org/nevibecode/skills/meowa-ai-game-assets.md) — скилл · 1400 установок
- [retrodiffusion](https://affpapa.org/nevibecode/skills/retrodiffusion.md) — скилл · 654 установки
- [fal-gamedev](https://affpapa.org/nevibecode/skills/fal-gamedev.md) — скилл · 432 установки
- [Retro Diffusion Pixel Art](https://affpapa.org/nevibecode/mcp/retro-diffusion-pixel-art.md) — MCP-сервер · ★ 8 у репозитория
- [transparent-cutout-cleanup](https://affpapa.org/nevibecode/skills/transparent-cutout-cleanup.md) — скилл · ★ 51 у репозитория

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