Skip to main content
Glama
deenesjaruzh
KINGMATTCREATIVES

Cavalry MCP Bridge

by KINGMATTCREATIVES
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Local

Cavalry Motion App MCP Bridge

一个模型上下文协议（MCP）服务器，可将AI助手（如Claude Desktop、Antigravity、Cursor和ChatGPT）直接连接到Cavalry——Scene Group开发的程序化2D运动图形和动画应用程序。

特性

  • 程序化图层创建：通过自然语言创建形状、文本、复制器、网格、噪点生成器、调色板、数学节点、变形器和粒子发射器。

  • 动态节点图连接：连接节点之间的输出和输入（例如，将噪点生成器连接到形状的缩放或旋转）。

  • 属性控制与关键帧：检查并更新任何属性，拖动时间轴，并添加动画关键帧。

  • 场景内省：查询活动合成元数据、图层层次结构和选定节点。

  • 渲染管线：将合成添加到渲染队列并触发批量渲染。

  • 原始脚本执行：针对Cavalry的原生api.*模块执行任意JavaScript。

架构

┌─────────────────────────┐          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. 将打开一个小面板，显示状态：在线（端口8080）。使用MCP服务器时请保持此面板打开。

（或者，如果您已激活Stallion扩展，它也会监听端口8080，并与本MCP服务器无缝协作。）

4. 测试连接

验证MCP服务器能否与Cavalry通信：

npm run test-connection

MCP客户端配置

Claude Desktop

将以下内容添加到您的claude_desktop_config.json中（位于Windows上的%APPDATA%\Claude\claude_desktop_config.json或macOS上的~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "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工具

工具

描述

cavalry_run_script

在Cavalry中使用api.*运行任意JavaScript代码。

cavalry_eval_expression

评估单个表达式并返回其值。

cavalry_get_scene_info

查询活动合成名称、帧数、FPS和图层数量。

cavalry_get_comp_layers

列出当前合成中的所有图层ID。

cavalry_get_selected_layers

获取当前选定图层的ID。

cavalry_create_layer

创建新图层/节点（basicShape、textShape、duplicator等）。

cavalry_set_attributes

设置图层上的一个或多个属性值。

cavalry_get_attributes

查询图层上的属性值。

cavalry_delete_layer

从场景中删除图层/节点。

cavalry_connect_attributes

在依赖图中连接源属性到目标属性。

cavalry_disconnect_attributes

断开属性连接。

cavalry_set_frame

将播放头拖动到特定帧。

cavalry_get_frame

获取当前帧号。

cavalry_set_keyframe

在指定帧处添加带有值的关键帧。

cavalry_playback_control

播放、停止或倒带时间轴。

cavalry_add_to_render_queue

将合成添加到渲染管理器。

cavalry_render_queue

开始渲染队列中的项目。

AI助手的示例提示

1. 动画噪点网格

"在Cavalry中创建一个12x12的圆角正方形网格，将噪点修改器附加到它们的旋转和缩放上，并将填充颜色设置为电蓝色。"

2. 动态文字排版

"在Cavalry中创建动态文字，标题为'ANTIGRAVITY'。将字体大小设置为120，居中，并为Y位置添加弹性的弹簧振荡。"

3. 径向爆发动画

"构建一个径向爆发动画，24条线从中心向外辐射，由步进复制器驱动，并设置关键帧使其从第0帧扩展到第45帧。"

许可证

MIT

This server cannot be installed

-
license - not tested
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • studio

    Build and run visual creative-production workflows from your AI agent.

  • Future Video Studio

    Create and manage cinematic AI video renders through the Future Video Studio Agent API.

  • distribea-mcp

    Generate images, video, music and voice from your CLI or AI agent. On-brand AI media toolkit.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/KINGMATTCREATIVES/Calvary-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server