lumorig/lumorig-mcp

Servidor MCP y habilidad para agentes de Lumorig

Crea, anima y exporta mascotas de marca desde tu agente de codificación. Describe una nueva mascota o usa la que ya tienes, luego publícala como Lottie, SVG animado, clips transparentes o un embed web en vivo.

Este repositorio contiene la configuración del servidor MCP alojado, una habilidad para el agente que le enseña cómo usar Lumorig, y pequeños ejemplos. El servidor se ejecuta en https://lumorig.com/api/mcp, por lo que no hay nada que construir ni alojar.

Instalación

Plugin para Claude Code (servidor y habilidad)

/plugin marketplace add lumorig/lumorig-mcp
/plugin install lumorig@lumorig

Claude Code (solo servidor)

claude mcp add --transport http lumorig https://lumorig.com/api/mcp

Luego ejecuta /mcp, selecciona lumorig y autentícate. Tu navegador se abrirá una vez.

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "lumorig": { "url": "https://lumorig.com/api/mcp" }
  }
}

Cursor mostrará "Needs login" junto a él. Haz clic y permite el acceso.

Claude Desktop y claude.ai

Ve a Settings → Connectors → Add custom connector, nómbralo Lumorig y usa la URL https://lumorig.com/api/mcp.

La habilidad por separado

npx skills add lumorig/lumorig-mcp

O copia skills/lumorig en la carpeta de habilidades de tu agente.

Con una clave API

Para servidores, CI o un cliente que no pueda abrir un navegador, crea una clave en el studio:

claude mcp add --transport http lumorig https://lumorig.com/api/mcp \
  --header "Authorization: Bearer lr_sk_…"

Qué pedirle a tu agente

• "Crea una mascota amigable de nutria para mi app de presupuestos y colócala en el estado vacío."
• "Reconstruye la mascota de esta URL de imagen como un vector con articulaciones, luego dame el código de inserción."
• "Exporta el saludo como Lottie."
• "Haz un avatar para chatbot que escuche, piense y hable, y conéctalo a mis eventos de chat."
• "Lee nuestro sitio web y sugiere tres mascotas que encajen con la marca."

Herramientas

Herramienta	Qué hace
create_mascot	Diseña una mascota a partir de una descripción, o usa una imagen de mascota existente
list_mascots, get_mascot	Navega por tus mascotas, sus looks, accesorios y paleta
edit_mascot	Cambia el diseño con palabras sencillas, o crea un nuevo look
recolor_mascot	Cambia los colores de la paleta al instante
switch_look	Convierte uno de los looks de la mascota en el actual
set_props, add_prop	Muestra, oculta o dibuja objetos que la mascota sostiene o usa
animate_mascot	Añade un movimiento predefinido o describe uno personalizado
export_mascot	Renderiza a Lottie, SVG animado, GIF, MP4, WebM, WebP, APNG, hoja de sprites, PNG, SVG, pegatina o logo
list_clips, create_clip, set_clip_kind, export_clip	Clips de movimiento que mantienen tu arte exacto subido
get_embed_code	Código para el componente web, React o Lottie
create_canvas	Una máquina de estados que dirige a la mascota desde eventos de la app
create_scene	Coloca la mascota en una escena vectorial ilustrada
analyze_website	Lee un sitio web y propone conceptos de mascota
suggest_animations	Ideas de movimiento que encajan con el personaje y tu producto
wait_for_job, list_jobs	Sigue trabajos de larga duración

Los parámetros completos están en la guía MCP.

Ejemplos

• examples/web: el reproductor en vivo en una página, usando una mascota de la galería pública
• examples/react-native: reproduce archivos Lottie exportados desde los eventos de tu app
• examples/api: crea una mascota con la API REST

Información útil

• Lumorig es un servicio alojado. Crear y editar consume créditos, y el plan gratuito te permite empezar.
• El servidor alojado no puede leer ni escribir archivos en tu máquina, por lo que acepta URLs de imágenes y devuelve URLs de descarga.
• También hay una CLI, un SDK de TypeScript y una API REST.

Soporte

Abre un issue aquí o envía un correo a [email protected].

Licencia

El contenido de este repositorio está bajo licencia MIT. El uso del servicio Lumorig se rige por sus Términos.