Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Resolume

БесплатноНе проверен

Resolume Arena/Avenue VJ control via FastMCP — clips, layers, decks for live visuals. For Cursor / Claude Desktop.

GitHubEmbed

Описание

Resolume Arena/Avenue VJ control via FastMCP — clips, layers, decks for live visuals. For Cursor / Claude Desktop.

README

Just Ruff Python FastMCP

📖 Installation Guide -- quick start, manual setup, and troubleshooting

MCP server for Resolume Arena VJ software control and automation - Live video mixing from natural language commands

License FastMCP Python Resolume


Quick Start

git clone https://github.com/sandraschi/resolume-mcp
cd resolume-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

Manual Setup

If you don't have just installed:

Features

  • Real-time Clip Control - Load, trigger, position, and opacity control for video clips
  • Layer Management - Opacity, blending modes, transitions, and bypass control
  • Effect Automation - Parameter control and effect bypassing for visual effects
  • Performance Tools - BPM synchronization and atomic batch operations
  • OSC Integration - Direct communication with Resolume Arena via OSC protocol
  • Live VJ Support - Optimized for live video performances and real-time mixing

Resolume Arena (host app): demo vs license

Resolume Arena is not included in this repoit is the VJ application you control via OSC.

There is no separate perpetual free tier. Resolume provides fully functional demos (Avenue and Arena) from the official download page: you may use them as long as you like; the main limits are a watermark on output and voice reminders until you purchase a license. See Resolumes Difference between Avenue and Arena (section Demo).

More detail: docs/user-guide/RESOLUME_ARENA_DEMO_AND_LICENSING.md.


Installation

Prerequisites

  • uv installed (RECOMMENDED)
  • Python 3.12+

Quick Start

Run immediately via uvx:

uvx resolume-mcp

Claude Desktop Integration

Add to your claude_desktop_config.json:

"mcpServers": {
  "resolume-mcp": {
    "command": "uv",
    "args": ["--directory", "D:/Dev/repos/resolume-mcp", "run", "resolume-mcp"]
  }
}

Prerequisites

  • Python 3.10 or higher
  • Resolume Arena (or Arena) installed and running
  • OSC enabled in Resolume preferences (ports 7000/7001)
  • Claude Desktop for MCP integration

Install via MCPB (Recommended)

  1. Download the latest .mcpb package from Releases
  2. Drag the .mcpb file to Claude Desktop
  3. Configure settings (see Configuration)
  4. Restart Claude Desktop

Install from Source

# Clone repository
git clone https://github.com/sandr/resolume-mcp.git
cd resolume-mcp

# Install with pip
pip install -e .

Quick Start

Claude Desktop Configuration

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "resolume-mcp": {
      "command": "python",
      "args": ["-m", "resolume_mcp"]
    }
  }
}

Resolume Setup:

  1. Open Resolume Arena Preferences OSC
  2. Enable OSC:
  3. Incoming Port: 7000
  4. Outgoing Port: 7001

First Steps

# Test the installation
Ask Claude: "What resolume-mcp tools are available?"

# Check Resolume connection
Ask Claude: "Check Resolume connection status"

# Load your first clip
Ask Claude: "Load C:/videos/my_clip.mp4 into layer 1, clip 1"

Configuration

Resolume OSC Setup

Required Configuration in Resolume Arena:

  1. Enable OSC: Preferences OSC Enable OSC
  2. Ports:
    • Incoming Port: 7000
    • Outgoing Port: 7001
  3. IP Address: 127.0.0.1 (localhost)
  4. Send Feedback: Optional (enables parameter monitoring)

Network Requirements

  • Resolume Arena must be running
  • UDP ports 7000-7001 must be available
  • Localhost connectivity required
  • No firewall blocking required for local communication

Advanced Configuration

See docs/user-guide/ for detailed setup guides.


Documentation

Document Description
Resolume demo & licensing Official demo mode (watermark), Avenue vs Arena, links
Integration Guide Setup with Claude Desktop
Architecture System design and components
Tool Reference Complete API documentation
Examples Working examples
Troubleshooting Common issues and solutions

Usage Examples

Basic VJ Operations

# Load video clips
Ask Claude: "Load my_clip.mp4 into layer 1, clip 1"

# Control playback
Ask Claude: "Trigger clip 1 on layer 1"

# Mix layers
Ask Claude: "Set layer 2 opacity to 70%"

# Apply effects
Ask Claude: "Set effect parameter 1 on layer 1, effect 1 to 0.8"

Live Performance Workflow

# Pre-performance setup
Ask Claude: "Set master BPM to 128"

# During performance
Ask Claude: "Fade layer 1 to 50% opacity over 2 seconds"
Ask Claude: "Switch to Add blend mode on layer 2"
Ask Claude: "Batch update: layer 1 opacity 0.3, layer 2 opacity 0.7, effect 1 param 1 to 0.9"

Advanced Examples

See docs/user-guide/ for complete VJ workflow examples.


Development

Setup Development Environment

# Clone repository
git clone https://github.com/sandr/resolume-mcp.git
cd resolume-mcp

# Install development dependencies
uv sync --dev

# Install pre-commit hooks
pre-commit install

Running Tests

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov

# Run specific test
uv run pytest tests/test_specific.py -v

Code Quality

# Lint with ruff
uv run ruff check .

# Format with ruff
uv run ruff format .

# Type check
uv run mypy .

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Development Workflow

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/-feature)
  3. Make your changes
  4. Run tests and linters
  5. Commit your changes (git commit -m 'Add feature')
  6. Push to the branch (git push origin feature/-feature)
  7. Open a Pull Request

Changelog

See CHANGELOG.md for version history and changes.


🛡️ Industrial Quality Stack

This project adheres to SOTA 14.1 industrial standards for high-fidelity agentic orchestration:

  • Python (Core): Ruff for linting and formatting. Zero-tolerance for print statements in core handlers (T201).
  • Webapp (UI): Biome for sub-millisecond linting. Strict noConsoleLog enforcement.
  • Protocol Compliance: Hardened stdout/stderr isolation to ensure crash-resistant JSON-RPC communication.
  • Automation: Justfile recipes for all fleet operations (just lint, just fix, just dev).
  • Security: Automated audits via bandit and safety.

Fleet Crossconnects (Companions)

resolume-mcp works completely standalone. You can optionally connect it with companion servers in the sandraschi fleet to unlock extended features:

Companion Server Feature Unlocked Status Setup
mixx-dj-mcp ndi-audio-video-stream, bpm-synced-clip-triggers Optional Install Guide

Self-Contained Companions: Fleet companions operate independently. Installing companions does not trigger transitive dependency chains.

License

This project is licensed under the MIT License - see the LICENSE file for details.


Acknowledgments


Support


Status: Beta - Ready for live VJ performances
MCP Version: FastMCP 3.4+
Maintained by: Sandra Schipal
Last Updated: 2026-09-12

from github.com/sandraschi/resolume-mcp

Установка Resolume

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/sandraschi/resolume-mcp

FAQ

Resolume MCP бесплатный?

Да, Resolume MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Resolume?

Нет, Resolume работает без API-ключей и переменных окружения.

Resolume — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Resolume в Claude Desktop, Claude Code или Cursor?

Открой Resolume на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Opencode Omniroute Plugin

OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc

GitHub Actionsавтор: GitHub Actions
80

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Antigravity Drawio

MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.

S-SUJAN-Sавтор: S-SUJAN-S

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

Compare Resolume with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai