motionprompts MCP

Un servidor MCP sobre un catálogo de 219 componentes de movimiento GSAP de calidad de producción. No genera animaciones: te da las que ya están resueltas y depuradas, te dice cómo componerlas sin que se peleen, y te avisa cuando el catálogo no tiene lo que pides.

Lo que expone

Related MCP server: Ultimate GSAP Master MCP Server

Instalación

Requiere Node 20 o superior. No necesita ninguna clave de API ni ninguna variable de entorno.

Claude Code

claude mcp add motionprompts -- node /ruta/al/repo/mcp/server.mjs

Claude Desktop y otros clientes

En el JSON de configuración del cliente:

{
  "mcpServers": {
    "motionprompts": {
      "command": "node",
      "args": ["/ruta/absoluta/al/repo/mcp/server.mjs"]
    }
  }
}

Comprueba que arranca:

npm run verify:mcp      # batería end-to-end sobre el protocolo real

Sobre claves de API: no hace falta ninguna

Este servidor no usa ninguna clave, y no puede gastar dinero de nadie. No lee variables de entorno, no pide secretos y no hace ni una sola llamada de red: abre ficheros del disco y devuelve texto. Es un lector de catálogo.

Si venías buscando el aviso sobre kie.ai: esa clave pertenece a una herramienta de autoría distinta —la que generó la fotografía de las páginas de ejemplo— que no forma parte de este paquete. Está excluida a propósito, así que aquí no hay nada capaz de generar imágenes ni de facturar a nadie. Si quieres fotografía para tus páginas, usa el servicio que prefieras con tu propia cuenta.

Cómo se usa bien

El orden importa, y es lo que más cuesta acertar:

1. plan_page primero. Devuelve secciones, no componentes: una página solo puede ser tan rica como la lista de la que se compone, y componer a partir de mecánicas de animación la deja en cinco secciones. Ajusta la lista al encargo real antes de seguir.

2. suggest_mechanics por sección, con avoid para excluir lo que ya usaste en otras páginas. Sin eso repetirás componente: los roles anchos ofrecen más de cien candidatos cuyas puntuaciones están empatadas, y reutilizar la misma cadena need da siempre el mismo primero.

3. get_integration_contract con todos los slugs a la vez, antes de escribir una línea.

4. get_component_prompt por componente. Re-viste, no reimplementes: cambia imágenes, textos, paleta, tipografía y número de elementos, y conserva la mecánica. Descarta un componente solo si su MECÁNICA no sirve, nunca por gusto estético.

Cinco roles están declarados como huecos del catálogo (faq, data, pricing, testimonial, reference): no hay nada para ellos entre los 219 componentes, y escribirlos desde los tokens del sistema de movimiento es la respuesta correcta. Para todo lo demás, adopta.

Ejemplos construidos con él

examples/ contiene cinco páginas completas hechas con este servidor, cada una con un README que documenta qué mecánica se adoptó, qué se re-vistió y qué se descartó y por qué. Sirven de referencia de uso y también de registro de los fallos que se fueron encontrando.

Qué NO lleva esta distribución

El código fuente de los componentes. Van los prompts, los metadatos, el motor de reglas de composición y el servidor. No van los index.html / script.js / styles.css de cada pieza.

No es una carencia: es cómo están pensados para usarse. El prompt es el producto — un brief autosuficiente que reconstruye la mecánica desde cero y la adapta a tu página, en vez de pegarte un componente ajeno dentro. Las cinco páginas de examples/ en el repositorio privado se construyeron así, adoptando mecánicas y re-vistiéndolas, no copiando código.

get_component con include: ['source'] lo dice explícitamente y te devuelve la demo en vivo y la URL del prompt. Todo lo demás —search_components, plan_page, suggest_mechanics, get_integration_contract, get_component_prompt, render_prompt— funciona igual.

Licencia

PolyForm Noncommercial 1.0.0 con atribución obligatoria. Uso no comercial permitido; el uso comercial requiere una licencia aparte. Cualquier uso permitido debe conservar el aviso y citar motionprompts.dev de forma visible. Ver LICENSE.

No es una licencia aprobada por la OSI, así que npm y GitHub la marcarán como no estándar. Si vas a apoyarte en ella para algo serio, que la revise un abogado: yo no lo soy.