Skip to content
MCP server

ferraus

Command-line audio workstation for stems, restoration, tuning, notation and mastering

Runs locallyStatus and history
Install
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.1.6
Listing updated
today

Similar MCP servers

About ferraus

ferraus is an MCP server for design and media. It runs locally on your machine and is started by your AI client.

ferraus ships as one cross-platform binary whose every command returns versioned JSON and writes a provenance sidecar next to each output, so a result can be reproduced with ferraus replay. ferraus schema prints a command's JSON Schema, and ferraus describe --agent summarises the whole command surface in under 4,000 tokens.

The command set spans conversion and editing, effects, restoration such as declip, dehum and dehiss, noise reduction, stem separation from Demucs to RoFormer ensembles, auto-tune and time stretch, MIDI and hum-to-instrument, notation in both directions, CLAP and VST3 hosting, mixing and mastering to a loudness target.

To use it from an assistant, start the MCP server with ferraus mcp serve and an --allow folder. The repository also provides skills for mixing, mastering, vocals and mix review, plus runnable examples.

Install

Run in a terminal

claude mcp add ferraus -- docker run -i --rm ghcr.io/djynnius/ferraus:v0.1.6

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ferraus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/djynnius/ferraus:v0.1.6"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ferraus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/djynnius/ferraus:v0.1.6"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "ferraus": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/djynnius/ferraus:v0.1.6"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ferraus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/djynnius/ferraus:v0.1.6"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ferraus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/djynnius/ferraus:v0.1.6"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

JSON on every command
Each command returns a stable, versioned JSON envelope that scripts and agents can chain.
Reproducible results
Provenance sidecars let ferraus replay rebuild any output.
Stem separation
Splits songs into vocals, drums, bass and other, in tiers up to RoFormer ensembles.
Restoration and noise reduction
Declip, dehum, declick, dehiss and model-based denoising with DeepFilterNet or RNNoise.
Hum to instrument
Turns a hummed idea into MIDI and renders it through a real instrument.
Notation both ways
Makes scores from audio or MIDI and performs sheet-music PDFs as audio.
Mastering
One command targets a loudness such as -14 LUFS for streaming.

Good for

  • Clean up a podcast recording in batch
  • Split a song into stems for a remix
  • Pitch-correct a vocal to the detected key
  • Turn a hummed melody into a piano part
  • Master a mix for streaming

ferraus FAQ

How do I start the MCP server?

Run ferraus mcp serve with an --allow folder, for example claude mcp add ferraus -- ferraus mcp serve --allow ~/music.

Does it replace FFmpeg?

The docs include an FFmpeg equivalents table for common commands, though ferraus also covers restoration, stems, tuning and mastering.

Is there a GUI?

No. It is a command-line tool for scripts and AI agents.

How is it distributed?

The registry lists an OCI image, ghcr.io/djynnius/ferraus.

How do I add ferraus to Claude Code?

Run this command in your terminal: claude mcp add ferraus -- docker run -i --rm ghcr.io/djynnius/ferraus:v0.1.6

What are the best alternatives to ferraus?

The closest alternatives to ferraus are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers