kacperchlebowicz/cavalry-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

31 stars 3 forks 품질 57 트렌드 11

Repository Install

MCP 서버는 Cavalry 애니메이션 소프트웨어에 Claude를 연결합니다. 레이어를 만들고, 속성을 설정, 키프레임과 같은, 프레임을 렌더링, 그리고 더 — 모두 자연 언어를 통해.

개요

MCP 서버는 Cavalry 애니메이션 소프트웨어에 Claude를 연결합니다. 레이어를 만들고, 속성을 설정, 키프레임과 같은, 프레임을 렌더링, 그리고 더 — 모두 자연 언어를 통해. MCP 서버는 Stallion Bridge를 통해 Cavalry에 JavaScript를 보냅니다. (127.0.0.1:8080). - Cavalry (Stallion 스크립트 활성화: ) - Node.js >= 18 "Hello World" Claude가 말하는 현상 텍스트 만들기 : 1. textShape layer 2. 만들기 텍스트 콘텐츠, 글꼴 크기 및 색상 3. 설정 바운드에 대한 위치 키 프레임을 추가 4. BounceOut 상승 적용 기본적으로 모양, textShape, null, colorPlane, 그룹, subMesh, 선형Gradient, duplicator, connectShape, noiseDeformer, stagger, trail, javaScriptUtility, javaScriptShape, imageAsset, videoAsset, soundAsset - position.x, position.y - 층 위치 - 회전 - 도에서 회전 - scale.x, scale.y - 스케일 - 불투명 - 층 불투명 (0–100) - 글꼴 크기 - 텍스트 층 글꼴 크기 - fill.color - 채색 (hex 끈) - 스트로크. 색깔, 치기.

개요(AI 번역)

어떻게 작동합니까?

MCP 서버는 Stallion Bridge를 통해 Cavalry에 JavaScript를 보냅니다 ([T0]]).

필수품

Cavalry (Stallion 스크립트 활성화 : ** 스크립트 > Stallion**)
Node.js >= 18

설치

Claude 데스크탑 구성

claude_desktop_config.json에 추가:

사용 가능한 도구

| 도구 | 설명 | |—||| | cavalry_ping | 카발리+세션이 닿을 수 있는 경우 확인 | | cavalry_run_script | 카발리의 임의 JavaScript 실행 | | cavalry_create_layer | 층 만들기(텍스트 모양, 기본 모양, null 등) | | [T5] | 층의 속성 설정 | | cavalry_get_attribute | 속성의 값을 읽다 | | cavalry_connect | 층간의 속성 연결 | | cavalry_keyframe | 특정 프레임의 키프레임 설정 | | cavalry_magic_easing | 키프레드 속성으로의 증가 | | cavalry_get_scene_layers | 현장의 모든 층 일람 | | [T11] | 현재 선택된 층 |

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

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:

Create a textShape layer

Set the text content, font size, and color

Add position keyframes for the bounce

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)

GitHub에서 전체 README 보기

설치

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"]
    }
  }
}