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 <--MCP (stdio)--> cavalry-mcp <--HTTP POST--> 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).

Related MCP server: Blender MCP

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

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)

• stroke.color, stroke.width — Stroke properties

License

MIT