text2d — MCP-сервер для 2D-ретро-пиксель-арта

Высокопроизводительный сервер Model Context Protocol (MCP), который позволяет ИИ-ассистентам процедурно генерировать, обрабатывать и экспортировать 2D-текстуры и тайлсеты в стиле ретро-пиксель-арта для разработки игр.

Возможности

• Преобразование изображений в ретро-пиксель-арт: Загрузка внешних PNG-файлов с автоматическим уменьшением масштаба, квантованием до ретро-палитр и применением упорядоченного дизеринга Байера через pixelize_image.

• Процедурный синтез текстур: Детерминированная генерация текстур wood (дерево), stone (камень/булыжник), brick (кирпич), grass (трава), metal (металл с заклепками) и water (водная рябь).

• Примитивы на уровне пикселей: Полный контроль через set_pixel, set_pixel_batch, draw_shape (линии, прямоугольники, окружности) и flood_fill.

• Ретро-палитры и квантование: Встроенные аутентичные цветовые палитры, включая PICO-8, DawnBringer 32 (DB32), Endesga 32, GameBoy, NES Classic и Cyberpunk Neon.

• Пост-обработка пиксель-арта: Упорядоченный дизеринг Байера (2x2, 4x4, 8x8) и пиксель-перфектные контуры толщиной 1px (внутренние/внешние).

• Варианты экспорта: PNG-файлы с целочисленным масштабированием с ближайшим соседом, Data URI в Base64, ASCII-превью с Unicode-блоками и 2D-сетки цветов в JSON.

Related MCP server: Piskel MCP Server

Визуальные примеры и галерея

1. Пикселизация изображений (pixelize_image)

Преобразуйте фотографии или ассеты высокого разрешения в аутентичный ретро-пиксель-арт с автоматическим квантованием палитры и дизерингом Байера.

2. Процедурный синтез текстур (generate_texture)

Создавайте бесшовные, детерминированные ретро-текстуры за секунды без внешних ассетов.

Матрица MCP-инструментов

Установка и использование

Вы можете установить и запустить text2d напрямую с GitHub без публикации в npm:

1. Глобальная установка (рекомендуется)

Установите глобально напрямую из репозитория GitHub:

npm install -g github:al3duc/text2d-mcp

После установки команда text2d будет доступна во всей системе.

Конфигурация MCP-клиента

Добавьте text2d в конфигурацию вашего MCP-клиента (например, claude_desktop_config.json, mcp_config.json или Cursor):

Вариант A: Использование глобальной установки (самый простой)

{
  "mcpServers": {
    "text2d": {
      "command": "text2d"
    }
  }
}

Вариант B: Прямой запуск через npx (без постоянной установки)

{
  "mcpServers": {
    "text2d": {
      "command": "npx",
      "args": [
        "-y",
        "github:al3duc/text2d-mcp"
      ]
    }
  }
}

Вариант C: Команда CLI Claude Code

Если вы используете Claude Code, зарегистрируйте его одной командой в терминале:

claude mcp add text2d -- npx -y github:al3duc/text2d-mcp

Вариант D: Локальный клон (для разработки)

git clone https://github.com/al3duc/text2d-mcp.git
cd text2d-mcp
npm install
npm run build

{
  "mcpServers": {
    "text2d": {
      "command": "node",
      "args": [
        "<PATH_TO_TEXT2D_REPOSITORY>/dist/index.js"
      ]
    }
  }
}

Примечание: Замените <PATH_TO_TEXT2D_REPOSITORY> на абсолютный путь к вашему клонированному репозиторию.

Сборка и тестирование

# Install dependencies
npm install

# Run unit & integration tests
npm test

# Build TypeScript to dist/
npm run build

# Generate procedural texture samples (wood, stone, brick, grass, metal, water)
npx tsx examples/generate_samples.ts

# Test converting realistic images from examples/input/ to pixel art
npx tsx examples/test_car_pixelize.ts

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.