Assimilate MCP
Control Assimilate Live FX / SCRATCH — professional color grading, compositing, and virtual production software — via MCP. Complete 1:1 integration of the Assimilate REST API with 88 tools across 14 categories.
Prerequisites
Setup
MCPorter
CODEBLOCK0
Claude Desktop
Add to claude_desktop_config.json:
CODEBLOCK1
Claude Code
CODEBLOCK2
Configuration
| Flag | Env Var | Default | Description |
|---|
| INLINECODE1 | INLINECODE2 | INLINECODE3 | Live FX host |
| INLINECODE4 |
ASSIMILATE_PORT |
8080 | REST API port |
|
--key |
ASSIMILATE_KEY | — | Authorization key |
|
--timeout |
ASSIMILATE_TIMEOUT |
30000 | HTTP timeout (ms) |
Example with custom port:
CODEBLOCK3
Tools (88)
| Category | Count | Key Tools |
|---|
| System | 8 | INLINECODE12 check_connection list_users INLINECODE15 |
| Projects |
7 |
list_projects enter_project create_project |
|
Groups | 9 |
list_groups get_current_group create_group |
|
Constructs | 10 |
list_constructs create_construct enter_construct |
|
Slots | 5 |
list_slots get_slot set_slot create_slot |
|
Versions | 5 |
list_versions get_version set_version |
|
Shots | 7 |
get_shot set_shot create_shot import_media |
|
Inputs | 4 |
get_inputs get_input set_input |
|
Color Grading | 5 |
get_grade set_grade get_framing set_framing |
|
Player | 8 |
enter_timeline set_playmode enter_shot exit_player |
|
Render | 10 |
start_render stop_render get_render_status |
|
Outputs | 6 |
list_outputs create_output set_output |
|
Snapshots | 2 |
render_snapshot get_shot_metadata |
|
Files | 2 |
list_directory find_media |
Usage Examples
Talk to your AI assistant in natural language:
- - "What projects are available?"
- "Import the ARRIRAW files from /Volumes/Shuttle/Day_14"
- "Warm up the gamma on this shot"
- "Set up ProRes 4444 output and render the timeline"
- "Take a snapshot of this frame"
MCPorter CLI
CODEBLOCK4
Remote Access
Live FX accepts connections on localhost by default. For remote machines, use an SSH tunnel:
CODEBLOCK5
Links
Assimilate MCP
通过MCP控制Assimilate Live FX / SCRATCH——专业调色、合成与虚拟制作软件。完整1:1集成Assimilate REST API，涵盖14个类别共88个工具。
前置条件
设置
MCPorter
bash
mcporter config add assimilate --command npx --args [-y, assimilate-mcp]
mcporter list assimilate
Claude Desktop
添加到claudedesktopconfig.json：
json
{
mcpServers: {
assimilate: {
command: npx,
args: [-y, assimilate-mcp]
}
}
}
Claude Code
bash
claude mcp add assimilate -- npx -y assimilate-mcp
配置
| 标志 | 环境变量 | 默认值 | 描述 |
|---|
| --host | ASSIMILATEHOST | 127.0.0.1 | Live FX主机 |
| --port |
ASSIMILATEPORT | 8080 | REST API端口 |
| --key | ASSIMILATE_KEY | — | 授权密钥 |
| --timeout | ASSIMILATE_TIMEOUT | 30000 | HTTP超时（毫秒） |
自定义端口示例：
json
{
mcpServers: {
assimilate: {
command: npx,
args: [-y, assimilate-mcp, --port=9090]
}
}
}
工具（88个）
| 类别 | 数量 | 关键工具 |
|---|
| 系统 | 8 | getsystem checkconnection listusers selectuser |
| 项目 |
7 | list
projects enterproject create_project |
|
组 | 9 | list
groups getcurrent
group creategroup |
|
构建体 | 10 | list
constructs createconstruct enter_construct |
|
插槽 | 5 | list
slots getslot set
slot createslot |
|
版本 | 5 | list
versions getversion set_version |
|
镜头 | 7 | get
shot setshot create
shot importmedia |
|
输入 | 4 | get
inputs getinput set_input |
|
调色 | 5 | get
grade setgrade get
framing setframing |
|
播放器 | 8 | enter
timeline setplaymode enter
shot exitplayer |
|
渲染 | 10 | start
render stoprender get
renderstatus |
|
输出 | 6 | list
outputs createoutput set_output |
|
快照 | 2 | render
snapshot getshot_metadata |
|
文件 | 2 | list
directory findmedia |
使用示例
用自然语言与AI助手对话：
- - 有哪些项目可用？
- 从 /Volumes/Shuttle/Day_14 导入ARRIRAW文件
- 让这个镜头的伽马值暖一些
- 设置ProRes 4444输出并渲染时间线
- 给这个帧拍个快照
MCPorter CLI
bash
mcporter call assimilate.check_connection
mcporter call assimilate.list_projects
mcporter call assimilate.enterproject(name: CommercialNike_Q3)
mcporter call assimilate.get_grade
远程访问
Live FX默认接受localhost连接。对于远程机器，请使用SSH隧道：
bash
ssh -f -N -L 8080:127.0.0.1:8080 user@livefx-host
链接
