MCP del Editor de Skins de Minecraft

Servidor MCP que permite a cualquier agente de IA compatible con MCP (Claude, ChatGPT, GitHub Copilot, Cursor, Gemini CLI…) crear y editar skins en vivo dentro del Editor de Skins de Minecraft. Tú ves cada cambio en el editor mientras el agente pinta, y puedes deshacerlo con Ctrl+Z.

🤖 Todo este proyecto fue creado con Claude AI "Opus 5.5" (Anthropic): el servidor, las herramientas MCP, la documentación y las pruebas.

• Endpoint MCP: https://editor-skins-mcp.vercel.app/mcp (HTTP “streamable”, sin autenticación, sin estado).

• Página informativa con el estado del servicio: https://editor-skins-mcp.vercel.app/.

Cómo funciona

 Agente ──(MCP / HTTP)──▶ /mcp ──▶ cola en Upstash Redis ◀──(consulta)── Editor (navegador)
        ◀── resultado ──────────── resultados en Redis ───(responde)──▶

1. En el editor, Agente IA → Conectar crea una sesión: el servidor devuelve un código (por ejemplo K7QM-X2PD-9RTA) y un token secreto que nunca sale del navegador.

2. Le das el código a tu agente. Cada herramienta que usa el agente deja una orden en la cola de esa sesión.

3. El editor consulta la cola (cada 350 ms cuando hay actividad, hasta 3 s en reposo), ejecuta las órdenes con su propio motor y devuelve el resultado.

4. La herramienta espera el resultado (hasta ~20 s) y se lo entrega al agente.

Como el editor ejecuta todo, el servidor no guarda skins: solo órdenes y resultados durante segundos.

Related MCP server: SkinForge MCP

Herramientas

Los errores se devuelven en español y con la causa concreta (por ejemplo, “La cara head.base.front mide 8×8…”), para que el agente pueda corregirse solo.

Estructura

api/mcp.js            Endpoint MCP (/mcp se reescribe aquí)
api/health.js         Estado del servicio y del almacenamiento
api/bridge/           session · poll · result: API que usa el editor
lib/tools.js          Definición de las herramientas (zod)
lib/relay.js          Sesiones, cola de órdenes y resultados
lib/store.js          Upstash Redis por REST (o memoria en local)
lib/http.js           CORS y respuestas JSON
lib/editor-core/      Copia del núcleo del editor (mapa UV y teoría del color)
public/index.html     Página informativa
scripts/dev-server.js Servidor local que imita a Vercel
scripts/sync-core.js  Actualiza lib/editor-core desde el repositorio del editor
test/                 Pruebas (node --test)

Despliegue en Vercel

1. Importa este repositorio en Vercel (Framework: Other; no necesita comando de compilación).

2. Conecta una base Upstash Redis al proyecto (Storage → Upstash → Connect). Vercel crea las variables solas.

3. Despliega y abre /api/health: debe responder "store": "upstash".

Variables de entorno reconocidas:

Si cambias el dominio del servidor, actualiza REMOTE.DEFAULT_BRIDGE_URL en js/config.js del editor (o usa Opciones avanzadas en el diálogo “Conectar con un agente de IA”).

Agregar el servidor a tu agente

Funciona con cualquier agente que admita servidores MCP remotos por HTTP ("streamable HTTP"), sin autenticación. Los menús pueden cambiar entre versiones:

Luego abre el editor, pulsa Agente IA → Conectar y escribe en tu agente: “Usa el editor de skins con el código XXXX-XXXX-XXXX y hazme…”.

Desarrollo local

npm install
npm run dev        # http://localhost:3000 (sin Upstash usa memoria)
npm test           # pruebas del relevo y del servidor MCP

Para probar con el editor local: http://localhost:8080/?bridge=http://localhost:3000.

Seguridad

• Solo quien tiene el código puede enviar órdenes a esa sesión; solo quien tiene el token (el navegador) puede leerlas y responder. El token se guarda como hash SHA-256.

• Los códigos tienen 12 caracteres aleatorios (≈ 60 bits) y vencen tras 3 horas sin uso; el editor se desconecta solo tras 30 minutos sin órdenes.

• La API del puente solo acepta peticiones del sitio del editor (CORS) y de localhost.

• No hay secretos en el repositorio: las credenciales viven en las variables de entorno de Vercel.

Créditos

Creado íntegramente con Claude AI "Opus 5.5" de Anthropic.

Proyecto independiente, sin afiliación con Mojang Studios ni Microsoft. Licencia MIT.