molanko-mcp-avatar-generator

适用于 molanko-avatar-generator 的 MCP 服务器。

该服务器暴露一个工具：

• generate_avatar —— 根据提供的图片或 Minecraft 玩家名/UUID 生成 Molanko 头像，然后将生成的 PNG 作为 MCP 图片结果返回。

需要提供图片来源：在 image 或 minecraftPlayer 中恰好提供一个。

运行

npm install
npm start

该服务器使用 MCP stdio 传输，因此可以由支持本地 stdio 服务器的 MCP 客户端启动。

Related MCP server: mcp-xmorf

工具：generate_avatar

图片来源

恰好提供其中一个：

• image —— MCP 风格的图片对象：{ "type": "image", "data": "<base64>", "mimeType": "image/png" }

• minecraftPlayer —— Minecraft 用户名或 UUID，带不带 UUID 连字符均可。服务器使用 Mojang 的 profile 和 session API 解析当前皮肤，然后直接从 Mojang 提供的纹理 URL 下载皮肤。

示例：

{ "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 }，并作为 averageColor 传递给 molanko-avatar-generator。

结果作为包含 PNG 的 MCP image 内容项返回。

Minecraft 玩家解析

minecraftPlayer 遵循与 Android 头像生成器相同的基本方法：UUID 直接规范化；用户名通过 api.mojang.com/users/profiles/minecraft/{name} 解析；然后通过 Mojang 的 session profile API 解析 UUID，以获取玩家的 textures 属性和皮肤 URL。无需任何第三方皮肤渲染或皮肤镜像服务。

服务器会报告有用的错误信息，例如无效的玩家标识符、玩家不存在、缺少皮肤纹理、Mojang 速率限制、Mojang 服务器错误以及网络/下载错误。

架构

本仓库有意设计为薄 MCP 适配层。Minecraft 玩家解析和头像渲染在服务器端完成，而实际的头像渲染仍保留在 molanko-avatar-generator 中。