Resolume
БесплатноНе проверенResolume Arena/Avenue VJ control via FastMCP — clips, layers, decks for live visuals. For Cursor / Claude Desktop.
Описание
Resolume Arena/Avenue VJ control via FastMCP — clips, layers, decks for live visuals. For Cursor / Claude Desktop.
README
📖 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)
- Download the latest
.mcpbpackage from Releases - Drag the
.mcpbfile to Claude Desktop - Configure settings (see Configuration)
- 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:
- Open Resolume Arena Preferences OSC
- Enable OSC:
- Incoming Port: 7000
- 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:
- Enable OSC: Preferences OSC Enable OSC
- Ports:
- Incoming Port:
7000 - Outgoing Port:
7001
- Incoming Port:
- IP Address:
127.0.0.1(localhost) - 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
- Fork the repository
- Create a feature branch (
git checkout -b feature/-feature) - Make your changes
- Run tests and linters
- Commit your changes (
git commit -m 'Add feature') - Push to the branch (
git push origin feature/-feature) - 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
printstatements in core handlers (T201). - Webapp (UI): Biome for sub-millisecond linting. Strict
noConsoleLogenforcement. - Protocol Compliance: Hardened
stdout/stderrisolation to ensure crash-resistant JSON-RPC communication. - Automation: Justfile recipes for all fleet operations (
just lint,just fix,just dev). - Security: Automated audits via
banditandsafety.
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
- FastMCP - Modern MCP server framework
- Claude Desktop - AI assistant platform
- {Other acknowledgments}
Support
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: [email protected]
Status: Beta - Ready for live VJ performances
MCP Version: FastMCP 3.4+
Maintained by: Sandra Schipal
Last Updated: 2026-09-12
Установка Resolume
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/sandraschi/resolume-mcpFAQ
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 ActionsRoblox Studio
Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce
автор: paralovAntigravity Drawio
MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.
автор: S-SUJAN-SFetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
автор: modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
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-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
автор: lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
Compare Resolume with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории ai
