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의 프로필 및 세션 API를 사용하여 현재 스킨을 확인한 다음, Mojang이 제공하는 텍스처 URL에서 스킨을 직접 다운로드합니다.

예시:

{ "minecraftPlayer": "Notch" }

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

image와 minecraftPlayer가 모두 제공되면 하나를 자동으로 선택하는 대신 요청이 거부됩니다.

옵션

• scale — 최근접 이웃 출력 배율

• outlineMode — 윤곽선 반경; 0이면 윤곽선이 비활성화됩니다

• outlineColor — auto, auto_darker, auto_lighter 또는 16진수 색상

• bgColor — auto, auto_lighter, auto_darker 또는 16진수 색상

• fillBackground — 출력 배경을 채울지 여부

• upscale48 — 32x32 아바타를 48x48 캔버스 중앙에 렌더링

• averageColor — 자동 윤곽선/배경 색상에 사용되는 색상의 선택적 재정의; auto, #RRGGBB 또는 #RGB 사용

averageColor는 별도의 도구가 아닙니다. 생성기가 자동으로 계산한 평균 색상을 재정의합니다. 생략하거나 auto로 설정하면 기본 생성기가 소스 스킨에서 평균 색상을 계산합니다. 16진수 값은 { r, g, b }로 구문 분석되어 averageColor로 molanko-avatar-generator에 전달됩니다.

결과는 PNG를 포함하는 MCP image 콘텐츠 항목으로 반환됩니다.

Minecraft 플레이어 확인

minecraftPlayer는 Android 아바타 생성기와 동일한 기본 방식을 따릅니다: UUID는 직접 정규화되고, 사용자 이름은 api.mojang.com/users/profiles/minecraft/{name}을 통해 확인되며, 그런 다음 UUID는 Mojang의 세션 프로필 API를 통해 확인되어 플레이어의 textures 속성과 스킨 URL을 얻습니다. 타사 스킨 렌더링 또는 스킨 미러링 서비스는 필요하지 않습니다.

이 서버는 잘못된 플레이어 식별자, 플레이어를 찾을 수 없음, 스킨 텍스처 누락, Mojang 속도 제한, Mojang 서버 오류, 네트워크/다운로드 오류와 같은 유용한 오류를 보고합니다.

아키텍처

이 저장소는 의도적으로 얇은 MCP 어댑터입니다. Minecraft 플레이어 확인과 아바타 렌더링은 서버 측에서 이루어지며, 실제 아바타 렌더링은 molanko-avatar-generator에 남아 있습니다.