KC

kacperchlebowicz/cavalry-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

31 stars 3 forks 品質 57 トレンド 11

Claudeをキャバレーアニメーションソフトウェアに接続するMCPサーバー。 レイヤーを作成し、属性を設定し、キーフレーム、フレームをレンダリングするなど、自然言語を通してすべてアニメーション化します.

概要

Claudeをキャバレーアニメーションソフトウェアに接続するMCPサーバー。 レイヤーを作成し、属性を設定し、キーフレーム、フレームをレンダリングするなど、自然言語を通してすべてアニメーション化します。 MCP サーバーは、Stallion ブリッジ経由でキャバレーに JavaScript を送信します (HTTP サーバーが 127.0.0.1:8080 でキャバレー内で実行)。 - キャバリー(Stallionスクリプトを有効にして:) - Node.js >= 18 「Hello World」というテキストを作成する クロードは1. テキストシェイプレイヤー2を作成します。 テキストコンテンツ、フォントサイズ、色3を設定します。 バウンス4に位置キーフレームを追加します。 BounceOut リースを適用 BasicShape、textShape、null、colorPlane、group、subMesh、LinearGradient、duplicator、ConnectShape、soundDeformer、stagger、 Trail、javaScriptUtility、javaScriptShape、imageAsset、videoAsset、SoundAsset - position.x, position.y — レイヤー位置 - 回転 — 度数の回転 - scale.x, scale.y — スケール - 不透明度 — レイヤーの不透明度 (0–100) - フォントサイズ - テキストレイヤーフォントサイズ - fill.color — 塗りつぶし色 (六角文字列) - ストローク。 色、打撃.

概要(AI 翻訳)

Claudeをキャバレーアニメーションソフトウェアに接続するMCPサーバー。 レイヤーを作成し、属性を設定し、キーフレーム、フレームをレンダリングするなど、自然言語を通してすべてアニメーション化します。

使い方

MCP サーバーは、Stallion ブリッジ ([127.0.0.1:8080]] で実行される HTTP サーバ) を介してキャバレーに JavaScript を送信します。

前提条件

  • 騎兵(Stallionスクリプトを有効にして: スクリプト > Stallion)
  • Node.js >= 18 ノード

セットアップ

Claudeデスクトップの設定

[claude_desktop_config.jsonに追加します。

利用可能なツール

| ツール | 概要 | お問い合わせ |【[[T2]】 | キャバリア+スタリオンが到達可能かどうか | | [cavalry_run_script | キャバレーでの任意のJavaScriptを実行 | | [cavalry_create_layer | レイヤー(textShape, BasicShape, nullなど)の作成 | | [cavalry_set_attribute | レイヤーに属性を設定 | | [cavalry_get_attribute | 属性値の読み方 | | [cavalry_connect | レイヤー間の属性の接続 | | [[[T8] | 特定のフレームにキーフレームを設定 | | 【cavalry_magic_easing | キーフレームの属性にリースを適用 | | 【[[T10]】 | シーン内の全てのレイヤーを一覧 | | [[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:

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