molanko-mcp-avatar-generator

MCP-сервер для molanko-avatar-generator.

Сервер предоставляет один инструмент:

• generate_avatar — генерирует аватар Molanko из предоставленного изображения или имени/UUID игрока Minecraft, а затем возвращает сгенерированный PNG как результат изображения MCP.

Требуется источник: укажите ровно один из параметров image или minecraftPlayer.

Запуск

npm install
npm start

Сервер использует транспорт MCP stdio, поэтому его могут запускать MCP-клиенты, поддерживающие локальные stdio-серверы.

Related MCP server: mcp-xmorf

Инструмент: generate_avatar

Источник

Укажите ровно один:

• image — объект изображения в формате MCP: { "type": "image", "data": "<base64>", "mimeType": "image/png" }

• minecraftPlayer — имя пользователя или UUID Minecraft, с дефисами UUID или без них. Сервер определяет текущий скин с помощью API профилей и сессий Mojang, а затем загружает скин напрямую по URL текстуры, предоставленному Mojang.

Примеры:

{ "minecraftPlayer": "Notch" }

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

Если указаны и image, и minecraftPlayer, запрос отклоняется, а не выбирается один из них молча.

Параметры

• scale — масштаб вывода с интерполяцией ближайшего соседа

• outlineMode — радиус контура; 0 отключает контур

• outlineColor — auto, auto_darker, auto_lighter или шестнадцатеричный цвет

• bgColor — auto, auto_lighter, auto_darker или шестнадцатеричный цвет

• fillBackground — заполнять ли фон вывода

• upscale48 — отображать аватар 32x32 по центру холста 48x48

• averageColor — необязательное переопределение цвета, используемого для автоматических цветов контура/фона; используйте auto, #RRGGBB или #RGB

averageColor — не отдельный инструмент. Он переопределяет автоматически рассчитанный средний цвет генератора. Если параметр опущен или установлен в auto, базовый генератор вычисляет средний цвет из исходного скина. Шестнадцатеричное значение разбирается в { r, g, b } и передаётся в molanko-avatar-generator как averageColor.

Результат возвращается как элемент содержимого MCP image, содержащий PNG.

Определение игрока Minecraft

minecraftPlayer использует тот же базовый подход, что и Android-генератор аватаров: UUID нормализуется напрямую; имя пользователя разрешается через api.mojang.com/users/profiles/minecraft/{name}; затем UUID разрешается через API профиля сессии Mojang для получения свойства textures игрока и URL скина. Сторонние сервисы рендеринга или зеркалирования скинов не требуются.

Сервер сообщает о полезных ошибках, таких как недопустимые идентификаторы игрока, игрок не найден, отсутствующая текстура скина, ограничения частоты запросов Mojang, ошибки сервера Mojang и ошибки сети/загрузки.

Архитектура

Этот репозиторий намеренно является тонким MCP-адаптером. Определение игрока Minecraft и рендеринг аватара выполняются на стороне сервера, а фактический рендеринг аватара остаётся в molanko-avatar-generator.