Cavalry Motion App MCP Bridge

Сервер Model Context Protocol (MCP), который подключает AI-ассистентов (например, Claude Desktop, Antigravity, Cursor и ChatGPT) напрямую к Cavalry — процедурному приложению для 2D-графики и анимации от Scene Group.

Возможности

• Создание процедурных слоёв: создавайте фигуры, текст, дубликаторы, сетки, генераторы шума, цветовые палитры, математические узлы, деформаторы и эмиттеры частиц с помощью естественного языка.

• Динамические соединения графа узлов: подключайте выходы и входы между узлами (например, соедините генератор шума с масштабом или вращением фигуры).

• Управление атрибутами и ключевыми кадрами: просматривайте и обновляйте любые свойства, перемещайтесь по временной шкале и добавляйте анимированные ключевые кадры.

• Интроспекция сцены: запрашивайте метаданные активной композиции, иерархию слоёв и выбранные узлы.

• Конвейер рендеринга: добавляйте композиции в очередь рендеринга и запускайте пакетный рендер.

• Выполнение произвольных скриптов: выполняйте произвольный JavaScript с использованием родного модуля api.* из Cavalry.

Архитектура

┌─────────────────────────┐          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(...)           │
                                                         └─────────────────────────────────┘

Быстрый старт

1. Установка зависимостей и сборка

Из директории этого проекта:

npm install
npm run build

2. Установка мостового скрипта в Cavalry

Запустите установщик, чтобы скопировать MCPBridge.js в папку скриптов Cavalry:

npm run install-bridge

На Windows этот скрипт копирует MCPBridge.js в %APPDATA%\Cavalry\Scripts\.

3. Запуск моста в Cavalry

1. Запустите Cavalry.

2. Перейдите в верхнее меню: Скрипты → MCPBridge.

3. Откроется небольшая панель с надписью Status: Online (Port 8080). Держите её открытой во время работы MCP-сервера.

(В качестве альтернативы, если у вас уже активен плагин Stallion, он также прослушивает порт 8080 и бесшовно работает с этим MCP-сервером).

4. Проверка соединения

Убедитесь, что MCP-сервер может общаться с Cavalry:

npm run test-connection

Конфигурация MCP-клиента

Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json (расположен в %APPDATA%\Claude\claude_desktop_config.json на Windows или ~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

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

Antigravity / Cursor / Пользовательский клиент

Добавьте в настройки или .cursor/mcp.json:

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

Доступные MCP-инструменты

Примеры промптов для AI-ассистентов

1. Анимированная сетка с шумом

«Создай сетку 12x12 из скруглённых квадратов в Cavalry, прикрепи модификатор шума к их вращению и масштабу, и установи цвет заливки на электрический синий.»

2. Кинетическая типографика

«Создай кинетический текст с заголовком 'ANTIGRAVITY' в Cavalry. Установи размер шрифта 120, выровняй по центру и добавь пружинистую осцилляцию по Y-позиции.»

3. Анимация радиального взрыва

«Построй анимацию радиального взрыва с 24 линиями, расходящимися от центра, управляемую шаговым дубликатором и анимированную от кадра 0 до кадра 45.»

Лицензия

MIT