{"type": "text"}

molanko-mcp-avatar-generator

MCP-Server für molanko-avatar-generator.

Der Server stellt ein Werkzeug bereit:

• generate_avatar — generiert einen Molanko-Avatar aus einem bereitgestellten Bild oder einem Minecraft-Spielernamen/UUID und gibt dann das generierte PNG als MCP-Bildergebnis zurück.

Eine Quelle ist erforderlich: Geben Sie genau eines von image oder minecraftPlayer an.

Ausführen

npm install
npm start

Der Server verwendet den MCP-stdio-Transport, sodass er von MCP-Clients gestartet werden kann, die lokale stdio-Server unterstützen.

Related MCP server: mcp-xmorf

Werkzeug: generate_avatar

Quelle

Geben Sie genau eines an:

• image — MCP-Stil-Bildobjekt: { "type": "image", "data": "<base64>", "mimeType": "image/png" }

• minecraftPlayer — Minecraft-Benutzername oder UUID, mit oder ohne UUID-Bindestriche. Der Server löst das aktuelle Skin über die Profil- und Session-APIs von Mojang auf und lädt das Skin dann direkt von der von Mojang bereitgestellten Textur-URL herunter.

Beispiele:

{ "minecraftPlayer": "Notch" }

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

Wenn sowohl image als auch minecraftPlayer angegeben werden, wird die Anfrage abgelehnt, anstatt stillschweigend eines auszuwählen.

Optionen

• scale — Ausgabeskalierung mit nächstem Nachbarn

• outlineMode — Umrissradius; 0 deaktiviert den Umriss

• outlineColor — auto, auto_darker, auto_lighter oder eine Hex-Farbe

• bgColor — auto, auto_lighter, auto_darker oder eine Hex-Farbe

• fillBackground — ob der Ausgabehintergrund gefüllt werden soll

• upscale48 — rendert den 32x32-Avatar zentriert auf einer 48x48-Leinwand

• averageColor — optionale Überschreibung für die Farbe, die für automatische Umriss-/Hintergrundfarben verwendet wird; verwenden Sie auto, #RRGGBB oder #RGB

averageColor ist kein separates Werkzeug. Es überschreibt die automatisch berechnete Durchschnittsfarbe des Generators. Wenn es weggelassen oder auf auto gesetzt wird, berechnet der zugrunde liegende Generator die Durchschnittsfarbe aus dem Quell-Skin. Ein Hex-Wert wird in { r, g, b } geparst und als averageColor an molanko-avatar-generator übergeben.

Das Ergebnis wird als MCP-image-Inhaltselement mit einem PNG zurückgegeben.

Minecraft-Spielerauflösung

minecraftPlayer folgt dem gleichen grundlegenden Ansatz wie der Android-Avatar-Generator: Eine UUID wird direkt normalisiert; ein Benutzername wird über api.mojang.com/users/profiles/minecraft/{name} aufgelöst; die UUID wird dann über die Session-Profil-API von Mojang aufgelöst, um die textures-Eigenschaft und die Skin-URL des Spielers zu erhalten. Es ist kein Drittanbieter-Skin-Rendering- oder Skin-Spiegelungsdienst erforderlich.

Der Server meldet nützliche Fehler wie ungültige Spieleridentifikatoren, Spieler nicht gefunden, fehlende Skin-Textur, Mojang-Ratenlimits, Mojang-Serverfehler und Netzwerk-/Downloadfehler.

Architektur

Dieses Repository ist absichtlich ein dünner MCP-Adapter. Die Minecraft-Spielerauflösung und die Avatar-Rendering finden serverseitig statt, während das eigentliche Avatar-Rendering in molanko-avatar-generator verbleibt.