KC

kacperchlebowicz/cavalry-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

31 stars 3 forks Качество 57 Тренд 11

Сервер MCP, который соединяет Клода с анимационным программным обеспечением Cavalry. Создавайте слои, устанавливайте атрибуты, анимируйте с помощью ключевых кадров, визуализируйте кадры и многое другое — все с помощью естественного языка.

Обзор

Сервер MCP, который соединяет Клода с анимационным программным обеспечением Cavalry. Создавайте слои, устанавливайте атрибуты, анимируйте с помощью ключевых кадров, визуализируйте кадры и многое другое — все с помощью естественного языка. Сервер MCP отправляет JavaScript в Cavalry через мост Stallion (сервер HTTP, работающий внутри Cavalry на 127.0.0.1:8080). - Cavalry (с включенным скриптом Stallion: ) - Node.js >= 18 Создайте подпрыгивающий текст с надписью «Hello World» Claude will: 1. Установите текстовое содержимое, размер шрифта и цвет 3. Добавьте клавишные кадры позиции для отскока 4. Скачать BounceOut easing BasicShape, textShape,null, colorPlane, group, subMesh, linearGradient, duplicator, connectShape, noiseDeformer,stagger, trail, javaScriptUtility, javaScriptShape, imageAsset, videoAsset, soundAsset - position.x, position.y - Положение слоя - Вращение - Вращение в градусах - scale.x, scale.y - Шкала - непрозрачность - Слой непрозрачности (0-100) - Размер шрифта - Размер шрифта текстового слоя - fill.color - Заполнить цвет (hex string) - ход. Цвет, удар.

Обзор (машинный перевод)

Сервер MCP, который соединяет Клода с анимационным программным обеспечением Cavalry. Создавайте слои, устанавливайте атрибуты, анимируйте с помощью ключевых кадров, визуализируйте кадры и многое другое — все с помощью естественного языка.

Как это работает

Сервер MCP отправляет JavaScript в Cavalry через мост Stallion (сервер HTTP, работающий внутри Cavalry на 127.0.0.1:8080).

Предпосылки

Кавалерия (с включенным скриптом Столлиона: Сценарии > Столлион) Node.js >= 18

Настройка

Настройка в Claude Desktop

Добавьте к своему [1]:

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

| Инструмент | Описание [скрыто] [скрыто] [[Т2]] Проверить, достижима ли кавалерия + жеребец | cavalry_run_script | Выполнить произвольный JavaScript в Cavalry | cavalry_create_layer | Создать слой (textShape, basicShape, null и т.д.) | [5][править править вики-текст] [[Т6]] Читать значение атрибута [7][править править код][править править код] cavalry_keyframe[править править вики-текст]] [9][править править код][править править код] [10][править править вики-текст] cavalry_get_selected_layers[править править вики-текст]

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

cavalry-mcp

MCP server that connects Claude to Cavalry animation software. Create layers, set attributes, animate with keyframes, render frames, and more — all through natural language.

How it works

Claude  cavalry-mcp  Stallion  Cavalry

The MCP server sends JavaScript to Cavalry via the Stallion bridge (an HTTP server running inside Cavalry on 127.0.0.1:8080).

Prerequisites

  • Cavalry (with Stallion script enabled: Scripts > Stallion)
  • Node.js >= 18

Setup

npm install
npm run build

Configure in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cavalry": {
      "command": "node",
      "args": ["/absolute/path/to/cavalry-mcp/dist/index.js"]
    }
  }
}

Available tools

Tool Description
cavalry_ping Check if Cavalry + Stallion are reachable
cavalry_run_script Execute arbitrary JavaScript in Cavalry
cavalry_create_layer Create a layer (textShape, basicShape, null, etc.)
cavalry_set_attribute Set attributes on a layer
cavalry_get_attribute Read an attribute value
cavalry_connect Connect attributes between layers
cavalry_keyframe Set a keyframe at a specific frame
cavalry_magic_easing Apply easing to keyframed attributes
cavalry_get_scene_layers List all layers in the scene
cavalry_get_selected_layers Get currently selected layers
cavalry_select_layers Select layers by ID
cavalry_delete_layers Delete layers by ID
cavalry_get_composition_info Get resolution, frame range, FPS
cavalry_set_current_frame Move the playhead
cavalry_render_png Render current frame as PNG
cavalry_set_generator Set a generator on a layer (ellipse, rectangle, etc.)
cavalry_duplicate_layer Duplicate a layer
cavalry_get_bounding_box Get a layer’s bounding box
cavalry_save_scene Save the scene
cavalry_open_scene Open a .cv scene file
cavalry_add_dynamic_attribute Add a dynamic attribute to a layer

Example conversation

You: Create a bouncing text that says “Hello World”

Claude will:

  1. Create a textShape layer
  2. Set the text content, font size, and color
  3. Add position keyframes for the bounce
  4. Apply BounceOut easing

Common layer types

basicShape, textShape, null, colorPlane, group, subMesh, linearGradient, duplicator, connectShape, noiseDeformer, stagger, trail, javaScriptUtility, javaScriptShape, imageAsset, videoAsset, soundAsset

Common attribute paths

  • position.x, position.y — Layer position
  • rotation — Rotation in degrees
  • scale.x, scale.y — Scale
  • opacity — Layer opacity (0–100)
  • fontSize — Text layer font size
  • fill.color — Fill color (hex string)
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "cavalry": { "command": "node", "args": ["/absolute/path/to/cavalry-mcp/dist/index.js"] } } }