animation
Destructive
Query, control, and edit Godot motion assets. Handle playback, keyframes, tracks, and player states directly from the MCP server.
Instructions
查询、控制和编辑动画。查询: list_players, get_info, get_details, get_keyframes。播放: play, stop, seek, blend。编辑: create, delete, update_props, add_track, remove_track, add_keyframe, remove_keyframe, update_keyframe。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | 方法参数 | |
| step | No | 关键帧对齐步进值 | |
| time | No | 关键帧时间（秒） | |
| type | No | IK：IK 类型 | |
| limit | No | IK：最大返回数量 | |
| speed | No | 播放速度，默认 1.0（blend） | |
| value | No | 关键帧值 | |
| action | Yes | 操作类型 | |
| length | No | 动画长度（秒） | |
| parent | No | IK：父节点路径 | |
| update | No | 跳转后立即更新节点（seek） | |
| seconds | No | 跳转位置（秒）（seek） | |
| from_end | No | 从末尾开始播放（play） | |
| bone_name | No | IK：骨骼名 | |
| insert_at | No | 轨道插入位置，-1 为末尾（add_track） | |
| loop_mode | No | 循环模式 | |
| node_path | No | AnimationPlayer 节点路径（除 list_players 外必填） | |
| root_path | No | 搜索起始节点路径（list_players） | |
| blend_time | No | 混合过渡时间（秒）（blend） | |
| keep_state | No | 停止时保持状态（stop） | |
| properties | No | IK：属性键值对 | |
| track_path | No | 轨道路径，如 "Sprite2D:frame"（add_track） | |
| track_type | No | 轨道类型（add_track） | |
| transition | No | 过渡曲线，1.0=线性 | |
| method_name | No | 方法名（method 轨道） | |
| track_index | No | 轨道索引 | |
| custom_blend | No | 自定义混合时间，-1 为默认（play） | |
| custom_speed | No | 播放速度，默认 1.0（play） | |
| library_name | No | 动画库名称（create/delete） | |
| project_path | No | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） | |
| animation_name | No | 动画名称 | |
| keyframe_index | No | 关键帧索引 | |
| load_autoloads | No | 是否加载 Autoload 上下文（默认 true） | |
| target_nodepath | No | IK：目标节点路径 |