Skip to main content
Glama
Cavi Character Animator MCP

Cavi Character Animator MCP

Official
by cavi-ai

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CAVI_ADOBE_DATANoPrivate server state: native helper builds and Character Animator journals. Defaults to ~/.local/share/cavi-adobe-mcp.~/.local/share/cavi-adobe-mcp
CAVI_ADOBE_WORKSPACEYesAbsolute directory every tool path is relative to. Required.
CAVI_CHARACTER_ANIMATOR_APPNoThe Character Animator .app to use. Without an override the server uses the newest installed version under /Applications with the application's bundle identifier.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Controls the installed macOS Character Animator through a bounded native adapter. Start with character_status and inspect. Claim session_control using the observed project_id. Save a new owned project copy before scene mutations. Native menus, visual observations and verified exported files are different evidence; never treat a dispatched command as completion. Inspect unresolved operation journals instead of automatically retrying. Server startup never launches the app, requests permissions, records a camera/microphone or signs into an account.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
character_statusA

Inspect app/control availability without launch, recording or permission prompts.

inspectC

Observe actual process, project-root evidence, native controls and unresolved operation state.

captureA

Capture only the Character Animator window with bounded OCR into a new workspace directory.

Observed text/geometry are visual evidence, not native scene IDs. Never starts recording.

session_controlB

Claim, renew, release, or resume a matching expired lease for one unknown operation.

Resume requires the expired lease ID, same owner, project ID and exact unknown operation ID. It renews ownership after process/root checks and dispatches no native command or chooser action. Claiming a prepared copy requires its private ID and a fresh observation of that exact native root.

project_prepare_copyA

Copy a closed saved workspace .chproj tree and verify its file hashes before native opening.

The source must not be open in Character Animator. This creates only a new workspace copy; pass its prepared_copy_id to project_open_prepared_copy, inspect the opened root, then claim it with session_control and the same prepared_copy_id.

project_open_prepared_copyA

Open only the exact closed-project copy previously prepared by project_prepare_copy.

Inspect the opened native root, then claim it with session_control and the same prepared_copy_id.

project_save_copyB

Native Save Project As into a new workspace project, then verify actual root and project files.

directory is an existing parent; name is a safe ASCII project name. Does not edit the source scene or discard unsaved state. A missing original file hash remains explicitly unavailable.

import_mediaB

Submit a hash-pinned workspace PSD puppet or WAV to the owned project.

PSDs use the native Import chooser. WAVs are handed to the already-running app; verify the project's Audio row because a handoff receipt does not confirm import.

scene_actionA

Dispatch one fixed menu action against the current owned-project selection.

Actions are add_to_new_scene, create_take_from_scene_audio, compute_lip_sync or export_png_wav. Copy the fingerprint from the latest inspect; scene/export completion remains unverified until inspected.

scene_exportA

Submit PNG Sequence and WAV for the current owned scene into a new workspace directory.

The result confirms native chooser submission only. Inspect actual files with export_inspect after export.

project_selectB

Select one uniquely OCR-matched Project-panel row by name and type.

extend controls additive selection; use the latest inspect fingerprint. OCR evidence is not a scene ID.

operation_controlA

Inspect or continue exact pending copy/import/export operations, verify a copy, or reconcile cancellation.

continue_export resumes only the journaled Export Scene/Go To chooser and output directory. continue_import never replays File > Import and requires the existing chooser, except for the single recorded pre-menu focus rejection. confirm_cancelled_import requires explicit user attestation and matching process/root/source evidence; it issues no native command and is not native-verified cancellation. cancel_unsubmitted applies only to an observed unsubmitted Save As chooser. reconcile_unsubmitted_copy records only a closed, pre-submit initial Save As stage after stable source checks; it sends no native command and does not imply user cancellation. reconcile_copy_after_exit resolves only a submitted initial Save As after the exact app process has exited, no matching app instance is running, and the original destination remains absent; it verifies no copy. abandon_after_exit archives an unknown operation on a first-hand owned project only after two stable observations confirm the original app process and all Character Animator instances have exited. It preserves project files and records the native outcome as unknown.

export_inspectB

Validate explicitly ordered native-export PNG/WAV/source hashes and exact dialogue sample timing.

Frame rate/order are caller declarations; proprietary project/puppet files are opaque provenance. This inspects existing files and does not perform a native Character Animator export.

export_ingestB

Create a pinned media receipt and measured PCM audio descriptor for Unity cutscene delivery.

Outputs go into a new directory. Preserves editable project/performance/XML provenance; does not establish native rigging, lip-sync correctness, playback or visual acceptance.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.3/5.0

Scored across 14 tools

Disambiguation3/5

Most tools have distinct roles once descriptions are parsed, but several clusters blur together: session_control (lease claim/renew/release/resume) vs operation_control (inspect/continue/reconcile pending operations) both deal with unknown-operation state, and project_prepare_copy vs project_save_copy vs project_open_prepared_copy vs export_ingest all involve copying/opening/exporting project trees. The dense prose helps disambiguate but still demands careful reading, so an agent could misselect between the lease and operation control paths.

Naming Consistency3/5

There is a loose resource-prefix scheme (character_, project_, scene_, export_, session_, operation_), but ordering is mixed: noun_verb (export_ingest, export_inspect), verb_noun (import_media, project_save_copy), and bare verbs (inspect, capture) all coexist. Readable overall, but no single predictable pattern.

Tool Count4/5

14 tools is within the appropriate band for a complex, multi-stage native-app orchestration domain (status, inspect, copy lifecycle, media import, scene actions, export verification). Each tool maps to a distinct workflow stage, though the operation_control mega-tool absorbs many sub-actions that could be counted separately.

Completeness4/5

The surface covers the full lifecycle: status/inspect/capture observation, project copy preparation and opening, media import, native scene actions and export, plus export hash inspection and Unity delivery receipt. Gaps are minor — no explicit app launch/close or undo/restore tool — but core workflows appear end-to-end covered.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues