Carla

v1.0.0Developer Toolsstable

An MCP server for controlling the Carla audio plugin host

audioclaplv2mcpmcp-server
Share:
12
Stars
0
Downloads
0
Weekly
0/5

What is Carla?

Carla is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for controlling the carla audio plugin host

An MCP server for controlling the Carla audio plugin host

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server for controlling the Carla audio plugin host

Use Cases

Control audio plugin hosts with LV2 and CLAP support.
Manage audio production workflows through AI interfaces.
agrathwohl

Maintainer

LicenseGPL-3.0
Languagepython
Versionv1.0.0
UpdatedApr 30, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx carla

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Carla

The Carla MCP Server is a Python-based MCP server providing 45 tools across 7 categories — session management, plugin control, audio routing, parameter automation, real-time analysis, JACK integration, and hardware control — for complete natural-language control of the Carla audio plugin host. It supports VST2/3, LV2, LADSPA, DSSI, AU, SF2, and SFZ plugins and integrates with the MixAssist dataset of professional mixing conversations to provide expert guidance. Audio engineers and AI researchers use it to automate complex mixing workflows, set up plugin chains, and run spectral analysis through AI prompts.

Prerequisites

  • Carla Audio Plugin Host installed (sudo apt install carla carla-dev on Ubuntu/Debian, or built from source)
  • JACK Audio Connection Kit installed (sudo apt install jackd2 jack-tools)
  • Python 3.12 or higher
  • pip or uv for dependency installation
  • An MCP-compatible client such as Claude Desktop
1

Install the Carla Audio Plugin Host

Install Carla from your distro's package manager or build from source for the latest features. The server requires the Carla Python bindings to be accessible.

# Ubuntu/Debian
sudo apt install carla carla-dev jackd2 jack-tools
2

Clone the server repository

Clone the carla-mcp-server repository and enter the project directory.

git clone https://github.com/agrathwohl/carla-mcp-server.git
cd carla-mcp-server
3

Install Python dependencies

Install the required Python packages. Use the dev extras if you plan to run tests.

pip install -r requirements.txt
# Or with dev tools:
pip install -e ".[dev]"
4

Set environment variables for Carla

Export the Carla library paths so Python can import the carla_backend module. Adjust paths to match your Carla installation.

export CARLA_PATH=/usr/share/carla
export PYTHONPATH=$CARLA_PATH/source/frontend:$PYTHONPATH
export LD_LIBRARY_PATH=/usr/lib/carla:$LD_LIBRARY_PATH
5

(Optional) Set up MixAssist dataset

Download the MixAssist dataset of 640 professional mixing conversations to enable expert audio engineering guidance through the MCP server.

python setup_mixassist.py --download
6

Configure your MCP client

Add the server to your MCP client configuration. The CARLA_PATH and PYTHONPATH env vars must be set so the server can find the Carla backend.

{
  "mcpServers": {
    "carla-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["/path/to/carla-mcp-server/server.py"],
      "env": {
        "CARLA_PATH": "/usr/share/carla",
        "PYTHONPATH": "/usr/share/carla/source/frontend"
      }
    }
  }
}
7

Start the MCP server

Launch the server directly to verify it starts without errors. Add --debug for verbose output.

python server.py --debug --log-level INFO

Carla Examples

Client configuration (Claude Desktop)

Claude Desktop config pointing to the Carla MCP server Python script with required Carla library paths.

{
  "mcpServers": {
    "carla-mcp": {
      "type": "stdio",
      "command": "python",
      "args": ["/path/to/carla-mcp-server/server.py"],
      "env": {
        "CARLA_PATH": "/usr/share/carla",
        "PYTHONPATH": "/usr/share/carla/source/frontend",
        "LD_LIBRARY_PATH": "/usr/lib/carla"
      }
    }
  }
}

Prompts to try

Example prompts covering session management, plugin loading, automation, and analysis.

- "Load my mixing project and set up a drum bus with compression"
- "Create a filter sweep effect on the lead synth, sync it to tempo"
- "Analyze my mix and suggest improvements for better frequency balance"
- "Set up parallel compression for vocals with different verse/chorus settings"
- "Scan /usr/lib/lv2 for available LV2 plugins and list them"
- "Prepare this session for live performance with low latency"

Troubleshooting Carla

ImportError: No module named 'carla_backend'

The PYTHONPATH must include the Carla frontend source directory. Set PYTHONPATH=/usr/share/carla/source/frontend (adjust to your install path) and verify with: python -c "import carla_backend; print('OK')"

JACK connection errors when starting the server

Start the JACK daemon before launching the server: jackd -d alsa -r 44100 &. On systems with PulseAudio, use pasuspender to release the audio device before starting JACK.

MixAssist dataset tools return 'resource not found'

Run 'python setup_mixassist.py --download' to download the dataset and generate the .env configuration file. The dataset is optional but required for MixAssist MCP resources to function.

Frequently Asked Questions about Carla

What is Carla?

Carla is a Model Context Protocol (MCP) server that mcp server for controlling the carla audio plugin host It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Carla?

Follow the installation instructions on the Carla GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Carla?

Carla works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Carla free to use?

Yes, Carla is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "carla": { "command": "npx", "args": ["-y", "carla"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Carla?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides