text2d — Servidor MCP de Arte Pixel Art Retro 2D

Un servidor de alto rendimiento del Protocolo de Contexto de Modelos (MCP) que permite a los asistentes de IA generar, manipular y exportar de forma procedural texturas y tilesets de arte pixel art retro 2D para el desarrollo de videojuegos.

Características

• Conversión de Imagen a Pixel Art Retro: Ingiere archivos PNG externos y automáticamente reduce la escala, cuantiza a paletas retro y aplica tramado Bayer mediante pixelize_image.

• Síntesis de Texturas Procedurales: Generación determinista de wood, stone (adoquín/roca), brick, grass, metal (placas cepilladas con remaches) y causticas de water.

• Primitivas a Nivel de Píxel: Control total mediante set_pixel, set_pixel_batch, draw_shape (líneas, rectángulos, círculos) y flood_fill.

• Paletas Retro y Cuantización: Paletas de colores auténticas integradas, incluyendo PICO-8, DawnBringer 32 (DB32), Endesga 32, GameBoy, NES Classic y Cyberpunk Neon.

• Post-Procesado de Pixel Art: Tramado ordenado de Bayer (2x2, 4x4, 8x8) y contornos pixel-perfect de 1px interior/exterior.

• Opciones de Exportación: Archivos PNG con escalado de enteros por vecino más cercano, URI de datos Base64, vistas previas de bloques Unicode ASCII y cuadrículas de colores JSON 2D.

Related MCP server: Piskel MCP Server

Ejemplos Visuales y Galería

1. Pixelización de Imagen (pixelize_image)

Convierte fotos o activos realistas de alta resolución en arte pixel art retro auténtico con cuantización automática de paleta y tramado Bayer.

2. Síntesis de Texturas Procedurales (generate_texture)

Genera texturas retro deterministas y sin fisuras en segundos sin activos externos.

Matriz de Herramientas MCP

Instalación y Uso

Puedes instalar y ejecutar text2d directamente desde GitHub sin publicarlo en npm:

1. Instalación Global (Recomendada)

Instala globalmente directamente desde el repositorio de GitHub:

npm install -g github:al3duc/text2d-mcp

Una vez instalado, el comando text2d está disponible en todo el sistema.

Configuración del Cliente MCP

Añade text2d a tu configuración de cliente MCP (por ejemplo, claude_desktop_config.json, mcp_config.json o Cursor):

Opción A: Usando Instalación Global (Más Simple)

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

Opción B: Ejecución Directa mediante npx (Sin instalación permanente)

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

Opción C: Comando CLI de Claude Code

Si usas Claude Code, regístralo con un solo comando de terminal:

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

Opción D: Clon Local (Desarrollo)

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

Nota: Reemplaza <PATH_TO_TEXT2D_REPOSITORY> con la ruta absoluta a tu repositorio clonado.

Compilación y Pruebas

# 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

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.