### High-Performance UDP Server Setup Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Steps to set up the optional high-performance UDP server for real-time parameter control, such as with the XY Mouse Controller example. This involves copying script files and configuring Ableton Live. ```bash cd experimental_tools/xy_mouse_controller pip install -r requirements.txt python mouse_parameter_controller_udp.py ``` -------------------------------- ### Troubleshooting: Test Components Individually Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Commands to individually test key components of the Ableton MCP Extended setup. This helps diagnose issues by verifying Python installation, the MCP server's direct execution, and the network connection to Ableton Live. ```bash # Test Python installation python --version # Test MCP server directly python MCP_Server/server.py # Test Ableton connection (with Ableton running) python -c "import socket; s = socket.socket(); s.connect(('localhost', 9877)); print('✅ Connected')" ``` -------------------------------- ### Install and Run UDP Server Example Source: https://github.com/uisato/ableton-mcp-extended/blob/main/README.md Instructions for installing the hybrid UDP server and running an example tool for real-time parameter control in Ableton Live. This involves copying files and executing a Python script. ```bash # Install the hybrid server cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/ # Try the XY Mouse Controller example cd experimental_tools/xy_mouse_controller python mouse_parameter_controller_udp.py ``` -------------------------------- ### Clone Ableton MCP Extended Repository (Bash) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Clones the Ableton MCP Extended project from GitHub to your local machine. This step requires Git to be installed and configured. ```bash git clone https://github.com/uisato/ableton-mcp-extended.git cd ableton-mcp-extended ``` -------------------------------- ### Verify Python Package Installation (Python) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Confirms that the Python package for Ableton MCP Extended has been installed correctly. It imports a class from the package and prints a success message. ```python from mcp.server.fastmcp import FastMCP; print('✅ Python package installed successfully!') ``` -------------------------------- ### Find Installation Path on Windows (Bash) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md A command to help users find the absolute path to the MCP_Server/server.py script within their Ableton MCP Extended installation directory on Windows. This path is needed for AI assistant configurations. ```bash # In your ableton-mcp-extended folder, run: echo %CD%\MCP_Server\server.py ``` -------------------------------- ### Basic Installation Tests Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Natural language commands to test the core functionality of the Ableton MCP Extended integration. These tests verify if the AI assistant can interact with Ableton Live to retrieve session information, create tracks, and list existing tracks. ```natural_language "Get information about my current Ableton session" - Should return details about your Ableton project "Create a new MIDI track" - Should create a new track in Ableton "What tracks do I currently have?" - Should list your tracks ``` -------------------------------- ### Find Installation Path on macOS (Bash) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md A command to help users find the absolute path to the MCP_Server/server.py script within their Ableton MCP Extended installation directory on macOS. This path is required for AI assistant configurations. ```bash # In your ableton-mcp-extended folder, run: echo $PWD/MCP_Server/server.py ``` -------------------------------- ### Install Ableton MCP Extended Source: https://github.com/uisato/ableton-mcp-extended/blob/main/README.md Clones the project repository, navigates into the directory, and installs the package using pip. This sets up the necessary Python environment for the Ableton MCP server. ```bash git clone https://github.com/uisato/ableton-mcp-extended.git cd ableton-mcp-extended pip install -e . ``` -------------------------------- ### Install Ableton MCP Extended Package (Bash) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Installs the Ableton MCP Extended Python package in editable mode. This command ensures that changes to the project code are immediately reflected without reinstallation. ```bash pip install -e . ``` -------------------------------- ### Configure Claude Desktop for Ableton MCP (JSON) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Provides the JSON configuration structure for Claude Desktop to connect to the Ableton MCP server. This involves specifying the command to run the Python server script. ```json { "mcpServers": { "AbletonMCP": { "command": "python", "args": [ "C:\\path\\to\\ableton-mcp-extended\\MCP_Server\\server.py" ] } } } ``` -------------------------------- ### ElevenLabs Voice Integration Configuration Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Configuration details for integrating ElevenLabs voice generation into your workflow. This includes obtaining an API key and adding the ElevenLabs server configuration to your AI assistant's settings. ```json { "mcpServers": { "AbletonMCP": { "command": "python", "args": ["C:/path/to/MCP_Server/server.py"] }, "ElevenLabs": { "command": "python", "args": ["C:/path/to/elevenlabs_mcp/server.py"], "env": { "ELEVENLABS_API_KEY": "your-api-key-here" } } } } ``` -------------------------------- ### Verify AI Connection Status Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Instructions to verify the connection and loaded tools for your AI assistant (Claude Desktop or Cursor) after installation. This confirms that the MCP tools are recognized by the AI. ```text For Claude Desktop: Look for a 🔨 hammer icon in the chat interface - this indicates MCP tools are loaded. For Cursor: You'll see a green dot next to the MCP server icon, and a message saying "40 tools enabled". You might have to restart your AI assistant in order for changes to impact. ``` -------------------------------- ### Install Python Packages Source: https://github.com/uisato/ableton-mcp-extended/blob/main/experimental_tools/xy_mouse_controller/README.md Command to install necessary Python libraries for the Ableton MCP Extended project, including pynput for mouse tracking and screeninfo for screen resolution detection. ```bash pip install pynput screeninfo ``` -------------------------------- ### Ableton Remote Script Path for Windows (APIDOC) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Specifies the directory on Windows where Ableton Live looks for user-created remote scripts. This path is essential for placing the AbletonMCP remote script files. ```APIDOC Windows Remote Scripts Directory: C:\Users\[YourUsername]\Documents\Ableton\User Library\Remote Scripts\ Quick Access: Paste `%USERPROFILE%\Documents\Ableton\User Library\Remote Scripts` into File Explorer's address bar and press Enter. ``` -------------------------------- ### Configure Cursor IDE for Ableton MCP (JSON) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Details the JSON configuration for Cursor IDE to integrate with the Ableton MCP server. It specifies the command and arguments needed to launch the Python server script. ```json { "mcpServers": { "AbletonMCP": { "command": "python", "args": [ "C:/path/to/ableton-mcp-extended/MCP_Server/server.py" ] } } } ``` -------------------------------- ### Ableton Remote Script Path for macOS (APIDOC) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/INSTALLATION.md Specifies the directory on macOS where Ableton Live looks for user-created remote scripts. This path is crucial for installing the AbletonMCP remote script files. ```APIDOC macOS Remote Scripts Directory: ~/Library/Preferences/Ableton/Live [Version]/User Remote Scripts/ Quick Access: In Finder, press Cmd + Shift + G, paste `~/Library/Preferences/Ableton/`, navigate to your Live version folder, then `User Remote Scripts`. ``` -------------------------------- ### Run Mouse Parameter Controller (Interactive) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/experimental_tools/xy_mouse_controller/README.md Execute the main Python script in interactive mode. It connects via TCP for setup, initializes UDP for updates, and prompts the user to select the target track, device, and parameters for mouse X and Y axes. ```bash python mouse_parameter_controller_udp.py ``` -------------------------------- ### Run Mouse Parameter Controller (Direct Mapping) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/experimental_tools/xy_mouse_controller/README.md Execute the Python script with direct mapping arguments for track, device, and parameter indices, bypassing interactive setup. This allows for immediate control based on predefined indices. ```bash python mouse_parameter_controller_udp.py 0 0 0 1 ``` -------------------------------- ### ElevenLabs Voice Integration Configuration Source: https://github.com/uisato/ableton-mcp-extended/blob/main/README.md Example JSON configuration for an AI assistant's settings, demonstrating how to include both the Ableton MCP server and an ElevenLabs MCP server. This allows for text-to-speech generation and import into Ableton sessions. ```json { "mcpServers": { "AbletonMCP": { "command": "python", "args": ["/path/to/ableton-mcp-extended/server.py"] }, "ElevenLabs": { "command": "python", "args": ["/path/to/elevenlabs_mcp/server.py"], "env": { "ELEVENLABS_API_KEY": "your-api-key-here" } } } } ``` -------------------------------- ### Configure Ableton Live for MCP Source: https://github.com/uisato/ableton-mcp-extended/blob/main/README.md Guides users through setting up Ableton Live's preferences to use the installed AbletonMCP remote script. This involves selecting the script as a control surface and setting MIDI inputs/outputs. ```APIDOC Ableton Live Configuration: 1. Open Ableton Live. 2. Navigate to Preferences → Link, Tempo & MIDI. 3. Set Control Surface to "AbletonMCP". 4. Set Input and Output to "None". ``` -------------------------------- ### Install Ableton Remote Script Source: https://github.com/uisato/ableton-mcp-extended/blob/main/README.md Copies the Ableton MCP remote script to the correct Ableton Live user library directory. This allows Ableton Live to recognize and utilize the MCP control surface. ```python # Find your Ableton Remote Scripts folder: # - Windows: C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\ # - Mac: ~/Library/Preferences/Ableton/Live [Version]/User Remote Scripts/ # Create folder: AbletonMCP # Copy AbletonMCP_Remote_Script/__init__.py into this folder ``` -------------------------------- ### Ableton MCP Extended Command-Line Interface Source: https://github.com/uisato/ableton-mcp-extended/blob/main/experimental_tools/xy_mouse_controller/README.md Documentation for the command-line interface of the Ableton Mouse Parameter Controller. Covers positional arguments for direct mapping and various flags for configuration. ```APIDOC Usage: python mouse_parameter_controller_udp.py [track_idx device_idx x_param_idx y_param_idx] [options] Positional Arguments (zero-based indices): track_idx: Target track index. device_idx: Device index on the selected track. x_param_idx: Parameter index for mouse X-axis control. y_param_idx: Parameter index for mouse Y-axis control. Options: --debug Enable detailed client-side logging for troubleshooting. --no-console-updates Disable real-time status line updates for improved performance. Default: Enabled. --update-interval Minimum time between UDP updates. Controls the frequency of parameter sends. Example: 0.02 for 50Hz, 0.04 for 25Hz. Default: 0.02 --change-threshold Minimum normalized change (0.0–1.0) in mouse position to trigger a UDP update. Helps reduce unnecessary updates for minor movements. Default: 0.002 --strategy batch | individual Choose the UDP send strategy for parameter updates. 'batch': Bundles multiple parameter updates into single UDP packets. 'individual': Sends each parameter update in its own UDP packet. Default: batch --help Show this help message and exit. ``` -------------------------------- ### Run Client with Debug Mode Source: https://github.com/uisato/ableton-mcp-extended/blob/main/experimental_tools/xy_mouse_controller/README.md Launches the mouse parameter controller client with the --debug flag enabled to provide detailed logging for troubleshooting connection and UDP packet issues. ```bash python mouse_parameter_controller_udp.py --debug ``` -------------------------------- ### Run Mouse Parameter Controller (UDP Strategy) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/experimental_tools/xy_mouse_controller/README.md Execute the Python script and specify the UDP send strategy. Options include 'batch' for bundling updates or 'individual' for sending each parameter update separately. ```bash python mouse_parameter_controller_udp.py --strategy individual ``` -------------------------------- ### Run Mouse Parameter Controller (Configurable Options) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/experimental_tools/xy_mouse_controller/README.md Configure the Python script with specific options such as disabling console updates for performance, setting a custom UDP update interval (e.g., 10Hz), and adjusting the change threshold for sensitivity. ```bash python mouse_parameter_controller_udp.py --no-console-updates --update-interval 0.1 --change-threshold 0.001 ``` -------------------------------- ### Connect AI Assistant (Claude Desktop) Source: https://github.com/uisato/ableton-mcp-extended/blob/main/README.md Configuration for connecting Claude Desktop to the Ableton MCP server. This JSON object specifies the command to run the Python server script. ```json { "mcpServers": { "AbletonMCP": { "command": "python", "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"] } } } ``` -------------------------------- ### Ableton MCP Core Functionality Source: https://github.com/uisato/ableton-mcp-extended/blob/main/README.md Provides an overview of the core capabilities offered by the Ableton MCP server for controlling Ableton Live. This includes session management, track operations, MIDI clip editing, device parameter control, and browser integration. ```APIDOC Ableton MCP API Overview: Functionality: - Session and Transport Control: Start/stop playback, get session info (tempo, time signature, track count), manage scenes (create, delete, rename, fire). - Track Management: Create, rename, get info for MIDI/audio tracks; control track properties (volume, panning, mute, solo, arm); manage track grouping and folding. - MIDI Clip and Note Manipulation: Create/name MIDI clips, add/delete/transpose/quantize notes, batch edit notes, adjust clip loop parameters and follow actions. - Device and Parameter Control: Load instruments/effects by URI, list device parameters, set/batch-set device parameters (0.0-1.0 normalized). - Automation and Envelopes: Add/clear automation points, get clip envelope info. - Browser Integration: Navigate/list browser items, load items by path/URI, import audio files. - Voice & Audio Generation: Text-to-Speech integration (e.g., ElevenLabs MCP) for narration/vocals, custom voice cloning, AI sound effects, direct import into Ableton. - Extensible Framework: High-performance UDP protocol for real-time control, example XY Mouse Controller. ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.