Cavalry Motion App MCP Bridge

Un servidor de Protocolo de Contexto de Modelo (MCP) que conecta asistentes de IA (como Claude Desktop, Antigravity, Cursor y ChatGPT) directamente a Cavalry, la aplicación procedural de gráficos en movimiento y animación 2D de Scene Group.

Características

• Creación Procedural de Capas: Crear formas, texto, duplicadores, cuadrículas, generadores de ruido, paletas de colores, nodos matématicos, deformadores y emisores de patículas mediante lenguaje natural.

• Conexiones Dinámicas de Grafos de Nodos: Conectar salidas y entradas entre nodos (por ejempl, conectar un generador de ruido a la escal o rotación de una forma).

• Control de Atributos y Fotogramas Clave: Inspeccionar y actualizar cualquer propiedad, deslizarse por la línea de tiemp y añadir fotogramas clave animados.

• Introspección de Escena: Consultar metadatos de la compsición actia, jerarquías de capas y nodos seleccionados.

• Canl de Renderizado: Añadir compsiciones a la Cola de Renderizado y actiar renderizados por lotes.

• Ejecución de Scripts en Bruto: Ejecutar JavaScript arbitrario contra el módulo nativ api.* de Cavalry.

Arquitectura

┌─────────────────────────┐          stdio (MCP)         ┌─────────────────────────────────┐
│ AI Assistant / LLM      │ ◄──────────────────────────► │ Cavalry MCP Server              │
│ (Claude, Antigravity)   │                              │ (TypeScript / Node.js)          │
└─────────────────────────┘                              └────────────────┬────────────────┘
                                                                          │
                                                             HTTP POST    │ (http://127.0.0.1:8080)
                                                                          ▼
                                                         ┌─────────────────────────────────┐
                                                         │ In-Cavalry Script Bridge        │
                                                         │ (MCPBridge.js in Scripts menu)  │
                                                         │ ───► api.create(...)            │
                                                         │ ───► api.set(...)               │
                                                         │ ───► api.connect(...)           │
                                                         └─────────────────────────────────┘

Inicio Rápid

1. Instalar Dependencias y Compilar

Desde este directrio del proycto:

npm install
npm run build

2. Instalar el Script Puente en Cavalry

Ejecuta el instalador para copiar MCPBridge.js a tu carpeta de scripts de Cavalry:

npm run install-bridge

*En Windows, esto copia MCPBridge.js a %APPDATA%\Cavalry\Scripts\.*m

3. Iniciar el Puente en Cavalry

1. Inicia Cavalry.

2. Ve al menú superior: Scripts → MCPBridge.

3. Se abrirá un pequeño panel mostrando Status: Online (Port 8080).

(Alteativamente, si tienes la extensión Stallion actia, tamibién escucha en el puerto 8080 y funciona perectamente con este servidor MCP).

4. Probar la Conexón

Verifica que el servidor MCP puede comunicarse con Cavalry:

npm run test-connection

Configuración del Cliente MCP

Claude Desktop

Añade lo siguiene a tu claude_desktop_config.json (ubicado en %APPDATA%\Claude\claude_desktop_config.json en Windows o ~/Library/Application Supprt/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "cavalry": {
      "command": "node",
      "args": [
        "C:/Users/david/Documents/ANTIGRAVITY APP/CALVARY MCP/dist/index.js"
      ],
      "env": {
        "CAVALRY_BRIDGE_PORT": "8080"
      }
    }
  }
}

Antigravity / Cursor / Cliente Personalizado

Añade a tus configuraciones o .cursor/mcp.json:

{
  "mcpServers": {
    "cavalry": {
      "command": "node",
      "args": ["C:/Users/david/Documents/ANTIGRAVITY APP/CALVARY MCP/dist/index.js"]
    }
  }
}

***m

Herramientas MCP Disponibles

Ejemplos de Indicaciones para Asistentes de IA

1. Cuadrícula de Ruido Animada

"Cra una cuadrícula de 12x12 de cuadrados redondeados en Cavalry, añade un modificador de ruido a su rotación y escala, y establece el color de relleno a azul eléctrico."

2. Tipografía Cinética

"Cra texto cinético con el titular 'ANTIGRAVITY' en Cavalry. Establece el tamaño de fuete a 120, céntralo y añade una oscilación de resorte elástica a la posición Y."

3. Animación de Explosión Radial

"Construye una animación de explosión radial con 24 líneas que irradian hacia afera desde el centro, impulsada por un duplicador de pasos y claveada para expandirse del fotograma 0 al fotograma 45."

Licencia

MIT