Skip to main content
Glama
Cavi Character Animator MCP

Cavi Character Animator MCP

Official
by cavi-ai

Cavi Character Animator MCP

Work on a copy you own.

MCP server for Adobe Character Animator on macOS. It prepares closed project copies, tracks which session owns an open project, reads the running application's state, imports puppets and dialogue audio, exports scenes and verifies the exported PNG and WAV files.

The server drives the application you have installed and signed in to, through a native helper. Every dispatched command is reported as unverified until the application and the output files show it. Bring your own licensed application.

Related MCP server: Osiris Premiere MCP

Install

Requires macOS, Adobe Character Animator installed and signed in, the Swift command-line compiler (xcode-select --install; the server compiles its native helper on first use) and Python 3.15 or later with uv. The MCP host needs Accessibility access; capture also needs Screen Recording access. You supply your own licensed Adobe applications.

uv tool install cavi-character-animator-mcp

Upgrade with uv tool upgrade cavi-character-animator-mcp. To work from a checkout instead, see CONTRIBUTING.md.

Quickstart

Register the stdio server with your MCP client and set the workspace:

{
  "mcpServers": {
    "character-animator": {
      "command": "cavi-character-animator-mcp",
      "env": {"CAVI_ADOBE_WORKSPACE": "/absolute/path/to/workspace"}
    }
  }
}

If your client does not inherit your shell's PATH, use the absolute path that command -v cavi-character-animator-mcp prints. Then try a request like:

Check that Character Animator is reachable, prepare a copy of projects/Hero, open it and claim it.

The setup guide and first result walk through the workflow. Tool paths are relative to the workspace.

What you can do

  • Read the application: whether it is running and reachable, its process, project root, native controls and unresolved operation state, and a capture of its window.

  • Copy a closed project into the workspace with its file hashes verified, open the copy and claim it with a lease before any change.

  • Import a puppet PSD or dialogue WAV, select a puppet, audio or scene row by name and run one fixed menu action on the selection.

  • Submit a PNG Sequence and WAV export of the owned scene into a new directory, then validate the exported files against an explicit recipe and write a pinned media receipt with a measured audio descriptor.

  • Inspect, verify, continue or reconcile a recorded native operation, and keep unknown outcomes instead of retrying them.

Tool

Purpose

character_status

Report whether the application is running and reachable.

inspect

Read the process, project root, native controls and unresolved operation state.

capture

Capture the Character Animator window with text recognition into a new workspace directory.

session_control

Inspect, claim, renew, release or resume ownership of an open project.

project_prepare_copy

Copy a closed .chproj tree into the workspace and verify its file hashes.

project_open_prepared_copy

Open a prepared copy in the application.

project_save_copy

Save an owned project as a new copy.

import_media

Import a puppet PSD or a dialogue WAV.

scene_action

Run one menu action on the selection: add to a new scene, create a take from scene audio, compute lip sync or export PNG and WAV.

scene_export

Submit a PNG Sequence and WAV export of the owned scene into a new workspace directory.

project_select

Select a puppet, audio or scene row in the Project panel by name.

operation_control

Inspect, verify or continue a recorded native operation.

export_inspect

Validate exported PNG and WAV files, their hashes and the dialogue sample timing.

export_ingest

Write a pinned media receipt and a measured audio descriptor for the exported files.

See the tool reference for parameters and results.

Closed projects and recovery

For a closed Character Animator project, prepare a copy with project_prepare_copy, open that prepared copy, inspect its project root and claim it with session_control before editing. A WAV handoff receipt does not confirm import: check that the audio appears in the project's Audio rows. After a process exits, the operation control and session control tools provide explicit reconciliation and lease release actions; they preserve unknown outcomes and project files.

Keep workspace ownership records private. Each native operation is recorded before it runs. If an operation reports an unknown outcome, inspect the application and outputs or reconcile the recorded operation before trying again. See project copies and ownership and recovery and unknown outcomes.

Documentation

The documentation source is in docs/character-animator-mcp/source:

Configuration

Variable

Meaning

CAVI_ADOBE_WORKSPACE

Absolute directory every tool path is relative to. Required.

CAVI_ADOBE_DATA

Private server state: native helper builds and Character Animator journals. Defaults to ~/.local/share/cavi-adobe-mcp.

CAVI_CHARACTER_ANIMATOR_APP

The Character Animator .app to use.

Without an override the server uses the newest installed version under /Applications with the application's bundle identifier. An override that names another application is refused with APP_IDENTITY_MISMATCH.

Security

The server speaks MCP over stdio, sends no telemetry and uses no accounts. It controls Character Animator with the Accessibility and, for capture, Screen Recording permissions of the MCP host, so run it only for clients you trust. Tool paths are confined to the workspace, and the tools that change the project refuse any project that is not an owned copy. See the security model and SECURITY.md.

Contributing

See CONTRIBUTING.md for setup, checks and the rules for changes. This project follows the Code of Conduct.

License

MIT. See LICENSE.

Trademarks

Adobe and Character Animator are either registered trademarks or trademarks of Adobe in the United States and/or other countries. This project is not affiliated with, endorsed by, or sponsored by Adobe. It does not include or redistribute Adobe software, puppets or project files; you supply your own licensed application.

Available Tools

14 tools
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.

Inputs: directory (required). Returns: path, native, sha256, identity, +1 more

character_statusA
Read-onlyIdempotent

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

Inputs: no named parameters. Returns: native, reason, available, connected, +1 more

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.

Inputs: recipe (required), directory (required). Returns: name, schema, status, handoff, +5 more

export_inspectB
Read-onlyIdempotent

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.

Inputs: recipe (required). Returns: fps, name, schema, status, +7 more

import_mediaB
Destructive

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.

Inputs: kind (required), source (required), lease_id (required). Returns: kind, native, source, status, +5 more

inspectC
Read-onlyIdempotent

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

Inputs: no named parameters. Returns: native, project_id, pending_operation, launches_application

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.

Inputs: action (required), operation_id (required), lease_id, user_confirmed_cancelled. Returns: native, status, retry_safe, operation_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.

Inputs: prepared_copy_id (required). Returns: native, status, completion, project_id, +4 more

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.

Inputs: source (required), destination (required). Returns: files, source, status, destination, +4 more

project_save_copyB
Destructive

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.

Inputs: name (required), lease_id (required), directory (required). Returns: files, status, project_id, retry_safe, +4 more

project_selectB
Destructive

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.

Inputs: name (required), extend (required), lease_id (required), item_type (required), +1 more. Returns: name, extend, native, status, +6 more

scene_actionA
Destructive

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.

Inputs: action (required), lease_id (required), expected_fingerprint (required). Returns: action, status, completion, retry_safe, +5 more

scene_exportA
Destructive

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.

Inputs: name (required), lease_id (required), directory (required), expected_fingerprint (required). Returns: native, status, retry_safe, operation_id

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.

Inputs: action (required), owner, lease_id, ttl_seconds, +3 more. Returns: owner, state, lease_id, expires_at, +4 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Connects an MCP client to a locally installed Adobe Premiere Pro so editors can inspect projects and run structured editing operations—project creation and opening, linked audio/video insertion and trimming, cutting, SRT caption rendering, and native MP4 export—instead of navigating the UI repeatedly. Capability profiles limit access to inspection, editing, export, or filesystem authority as needed for each task.
      389
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables any MCP client to control After Effects, Premiere Pro, Photoshop and Illustrator through 182 native tools plus 500+ bundled community tools, covering layer/comp editing, rendering, export, plugin and extension discovery, and media downloads. Cross-app workflows move comps, layers, frames and MOGRTs between applications, while raw scripting escape hatches reach nearly any menu command or plugin action.
      182
      1
      MIT