molanko-mcp-avatar-generator

molanko-avatar-generator 用の MCP サーバーです。

このサーバーは1つのツールを公開します:

• generate_avatar — 提供された画像または Minecraft プレイヤー名/UUID から Molanko Avatar を生成し、生成された PNG を MCP 画像結果として返します。

ソースが必要です: image または minecraftPlayer のいずれか一方を正確に1つ指定してください。

実行

npm install
npm start

このサーバーは MCP stdio トランスポートを使用するため、ローカルの stdio サーバーをサポートする MCP クライアントから起動できます。

Related MCP server: mcp-xmorf

ツール: generate_avatar

ソース

次のうち正確に1つを指定してください:

• image — MCP 形式の画像オブジェクト: { "type": "image", "data": "<base64>", "mimeType": "image/png" }

• minecraftPlayer — Minecraft のユーザー名または UUID（UUID のハイフンの有無は問いません）。サーバーは Mojang のプロフィール API とセッション 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 に残ります。