molanko-mcp-avatar-generator

Servidor MCP para molanko-avatar-generator.

El servidor expone una herramienta:

• generate_avatar — genera un Molanko Avatar a partir de una imagen proporcionada o de un nombre/UUID de jugador de Minecraft, y luego devuelve el PNG generado como resultado de imagen MCP.

Se requiere una fuente: proporciona exactamente una de image o minecraftPlayer.

Ejecución

npm install
npm start

El servidor usa transporte MCP stdio, por lo que puede ser lanzado por clientes MCP que admitan servidores stdio locales.

Related MCP server: mcp-xmorf

Herramienta: generate_avatar

Fuente

Proporciona exactamente una:

• image — objeto de imagen estilo MCP: { "type": "image", "data": "<base64>", "mimeType": "image/png" }

• minecraftPlayer — nombre de usuario o UUID de Minecraft, con o sin guiones de UUID. El servidor resuelve la skin actual usando las API de perfil y sesión de Mojang, y luego descarga la skin directamente de la URL de textura proporcionada por Mojang.

Ejemplos:

{ "minecraftPlayer": "Notch" }

{ "minecraftPlayer": "069a79f4-44e9-4726-a5be-fca90e38aaf5" }

Si se proporcionan tanto image como minecraftPlayer, la solicitud se rechaza en lugar de elegir una silenciosamente.

Opciones

• scale — escala de salida de vecino más cercano

• outlineMode — radio del contorno; 0 desactiva el contorno

• outlineColor — auto, auto_darker, auto_lighter, o un color hexadecimal

• bgColor — auto, auto_lighter, auto_darker, o un color hexadecimal

• fillBackground — si se debe rellenar el fondo de la salida

• upscale48 — renderiza el avatar de 32x32 centrado en un lienzo de 48x48

• averageColor — anulación opcional para el color usado por los colores automáticos de contorno/fondo; usa auto, #RRGGBB, o #RGB

averageColor no es una herramienta separada. Anula el color promedio calculado automáticamente por el generador. Si se omite o se establece en auto, el generador subyacente calcula el color promedio a partir de la skin de origen. Un valor hexadecimal se analiza en { r, g, b } y se pasa a molanko-avatar-generator como averageColor.

El resultado se devuelve como un elemento de contenido image de MCP que contiene un PNG.

Resolución de jugador de Minecraft

minecraftPlayer sigue el mismo enfoque básico que el generador de avatares de Android: un UUID se normaliza directamente; un nombre de usuario se resuelve a través de api.mojang.com/users/profiles/minecraft/{name}; el UUID se resuelve luego a través de la API de perfil de sesión de Mojang para obtener la propiedad textures del jugador y la URL de la skin. No se requiere ningún servicio de terceros para renderizar o duplicar skins.

El servidor informa fallos útiles como identificadores de jugador no válidos, jugador no encontrado, textura de skin faltante, límites de tasa de Mojang, errores del servidor de Mojang y errores de red/descarga.

Arquitectura

Este repositorio es intencionalmente un adaptador MCP ligero. La resolución del jugador de Minecraft y el renderizado del avatar se realizan en el lado del servidor, mientras que el renderizado real del avatar permanece en molanko-avatar-generator.