text2d — 2D-Retro-Pixel-Art-Textur-MCP-Server

Ein leistungsstarker MCP-Server (Model Context Protocol), der KI-Assistenten dabei unterstützt, 2D-Retro-Pixel-Art-Texturen und Tilesets für die Spieleentwicklung prozedural zu erzeugen, zu bearbeiten und zu exportieren.

Features

• Bild-zu-Retro-Pixel-Art-Konvertierung: Importiert externe PNG-Dateien und verkleinert sie automatisch, quantisiert sie auf Retro-Paletten und wendet über pixelize_image Bayer-Dithering an.

• Prozedurale Texturerzeugung: Deterministische Generierung von wood, stone (Kopfstein/Fels), brick, grass, metal (gebürstete Platten mit Nieten) und water-Kaustiken.

• Primitive auf Pixel-Ebene: Volle Kontrolle über set_pixel, set_pixel_batch, draw_shape (Linien, Rechtecke, Kreise) und flood_fill.

• Retro-Paletten & Quantisierung: Integrierte authentische Farbpaletten, einschließlich PICO-8, DawnBringer 32 (DB32), Endesga 32, GameBoy, NES Classic und Cyberpunk Neon.

• Pixel-Art-Nachbearbeitung: Geordnetes Bayer-Dithering (2x2, 4x4, 8x8) sowie 1-Pixel-Innen-/Außenkonturen, pixelgenau.

• Exportoptionen: PNG-Dateien mit ganzzahliger Nearest-Neighbor-Skalierung, Base64-Daten-URIs, ASCII-Unicode-Blockvorschauen und 2D-JSON-Farbgittern.

Related MCP server: Piskel MCP Server

Visuelle Beispiele & Galerie

1. Bildpixelisierung (pixelize_image)

Konvertiere hochauflösende realistische Fotos oder Assets in authentische Retro-Pixel-Art – mit automatischer Palettenquantisierung und Bayer-Dithering.

2. Prozedurale Texturzeugung (generate_texture)

Erzeuge nahtlose, deterministische Retro-Texturen in Sekunden ohne externe Assets.

MCP-Tools-Matrix

Installation und Verwendung

Sie können text2d direkt von GitHub installieren und ausführen, ohne es auf npm zu veröffentlichen.

1. Globale Installation (Empfohlen)

Installieren Sie global direkt aus dem GitHub-Repository:

npm install -g github:al3duc/text2d-mcp

Nach der Installation ist der Befehl text2d systemweit verfügbar.

MCP-Client-Konfiguration

Fügen Sie text2d zu Ihrer MCP-Client-Konfiguration hinzu (z. B. claude_desktop_config.json, mcp_config.json oder Cursor):

Option A: Globale Installation verwenden (am einfachsten)

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

Option B: Direkte Ausführung über npx (keine dauerhafte Installation)

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

Option C: Claude Code CLI-Befehl

Wenn Sie Claude Code verwenden, registrieren Sie es mit einem einzigen Terminal-Befehl:

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

Option D: Lokales Klonen (Entwicklung)

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"
      ]
    }
  }
}

Hinweis: Ersetzen Sie <PATH_TO_TEXT2D_REPOSITORY> durch den absoluten Pfad zu Ihrem geklonten Repository.

Build und Test

# 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

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe die Datei LICENSE für Details.