Resolume MCP

Resolume MCP

MCP服务器 Resolume竞技场和大道公开206个工具，涵盖构图控制、播放、高级输出管理和显示恢复，因此AI助手可以通过REST、WebSocket和OSC操作Resolume。

它做什么

快速启动

# Clone and install
git clone https://github.com/drohi-r/resolume-mcp && cd resolume-mcp
uv sync

# Run the server (connects to Resolume on localhost:8080)
uv run python -m resolume_mcp

确保Resolume Arena或Avenue在启用REST API的情况下运行（首选项→ OSC/HTTP→ HTTP API）。

对于远程控制：

• 使用局域网或WireGuard，而不是公共互联网
• 集 RESOLUME_HOST 到远程机器
• 将该主机包含在 RESOLUME_ALLOWED_HOSTS

配置

服务器从环境变量中读取配置。所有这些国家都对当地发展有合理的默认。

建筑

graph TD
    A["Resolume MCP Server
resolume_mcp
206 tools · safety gate"] --> B
    A --> C
    A --> D
    B["REST Client
Composition · clips · layers · effects"] --> E
    C["WebSocket Client
Parameter subscriptions · state polling"] --> E
    D["OSC Client
Transport control"] --> E
    E["Resolume Arena / Avenue
HTTP API on port 8080"]

    F["Advanced Output Engine
XML inspection · atomic writes · backup"] -.-> A
    G["Safety Gate
16 destructive ops gated behind confirm"] -.-> A

    style A fill:#1a1a2e,stroke:#9B59FF,color:#fff
    style B fill:#1a1a2e,stroke:#9B59FF,color:#fff
    style C fill:#1a1a2e,stroke:#9B59FF,color:#fff
    style D fill:#1a1a2e,stroke:#9B59FF,color:#fff
    style E fill:#1a1a2e,stroke:#0f3460,color:#fff
    style F fill:#0f3460,stroke:#0f3460,color:#fff
    style G fill:#0f3460,stroke:#0f3460,color:#fff

克劳德桌面

将此添加到您的Claude Desktop配置中(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "resolume": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/resolume-mcp", "python", "-m", "resolume_mcp"],
      "env": {
        "RESOLUME_HOST": "127.0.0.1",
        "RESOLUME_HTTP_PORT": "8080",
        "RESOLUME_ALLOWED_HOSTS": "127.0.0.1,localhost,::1"
      }
    }
  }
}

VS代码/光标

添加 .vscode/mcp.json 在您的项目中：

{
  "servers": {
    "resolume": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/resolume-mcp", "python", "-m", "resolume_mcp"],
      "env": {
        "RESOLUME_HOST": "127.0.0.1",
        "RESOLUME_HTTP_PORT": "8080",
        "RESOLUME_ALLOWED_HOSTS": "127.0.0.1,localhost,::1"
      }
    }
  }
}

法典

创建一个 codex.json MCP配置文件：

{
  "mcpServers": {
    "resolume": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/resolume-mcp", "python", "-m", "resolume_mcp"],
      "env": {
        "RESOLUME_HOST": "127.0.0.1",
        "RESOLUME_HTTP_PORT": "8080",
        "RESOLUME_ALLOWED_HOSTS": "127.0.0.1,localhost,::1"
      }
    }
  }
}

然后使用以下命令运行Codex：

codex --mcp-config codex.json

技能

该服务器包括7种操作员技能——常见现场表演场景的结构化工作流程：

安全模型

• 读取操作 （快照、审计、参数获取）：始终安全，无需确认
• 破坏性行动 （清除、断开、删除）：需要 confirm_destructive=True
• 主机分配：仅 127.0.0.1, localhost，以及 ::1 默认情况下是允许的。通过以下方式显式添加LAN主机 RESOLUME_ALLOWED_HOSTS.Set * 允许任何主机。
• 高级输出XML写入：atomic（临时文件+重命名）以防止损坏
• 轮询循环：崩溃恢复--如果Resolume变得无法访问，则返回上次已知的状态

发展

# Install and sync dependencies
uv sync

# Run tests
uv run python -m pytest -v

许可证

Apache 2.0