ferraus

Name: ferraus
Author: djynnius

作者：djynnius版本 0.1.4i★ –i在你的电脑上运行

注册名称io.github.djynnius/ferraus

安装

概览

作者提供的说明（英文原文）

Command-line audio workstation: stems, restoration, tuning, sheet music, mastering. JSON everywhere.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 设计、图片与音频

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
注册中心没有列出需要填写的密钥。

你需要

Docker已安装 Docker

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "ferraus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/djynnius/ferraus:v0.1.4",
        "mcp",
        "serve",
        "--allow",
        "/work"
      ]
    }
  }
}

在终端中运行这条命令

claude mcp add ferraus -- docker run -i --rm ghcr.io/djynnius/ferraus:v0.1.4 mcp serve --allow /work

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "ferraus": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/djynnius/ferraus:v0.1.4",
        "mcp",
        "serve",
        "--allow",
        "/work"
      ]
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

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

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 djynnius 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“设计、图片与音频”中的其他服务器比较i

星标数多于此分类中其他 2202 个服务器的 0%
发布到注册中心的时间比此分类中其他 2202 个服务器的 97% 更新
基础检查结果等于或优于此分类中其他 2202 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

ferraus 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.4）于昨天进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Docker。

有什么可以替代它？

同一分类中有：Figma Context MCP, Claude Real Video, Figma MCP Server

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Figma Context MCP

作者：GLips

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

在你的电脑上运行★ 16,165MIT5个月前更新

安装

Claude Real Video

作者：HUANGCHIHHUNGLeo

Let any LLM watch a video locally — and search everything it has ever watched.

在你的电脑上运行★ 2,284MIT2个月前更新

安装

Figma MCP Server

作者：figma

The Figma MCP server brings Figma design context directly into your AI workflow.

在云端运行★ 2,15213个月前更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

ferraus

A command-line audio workstation for scripts and AI agents.

One cross-platform binary that edits, repairs, separates, tunes, transcribes, notates, and masters audio. Every command returns JSON and records how each file was made, so scripts and agents can chain it without a GUI and reproduce any result. (The *au* is for audio.)

ferraus separate song.mp3                         # vocals, drums, bass, other

ferraus denoise take.wav --auto -o clean.wav # learn the noise, remove it ferraus tune vocal.wav --key auto -o tuned.wav # pitch-correct to the detected key ferraus hum idea.wav --to piano -o idea.piano.wav # humming → MIDI → a real instrument ferraus mix balance stems/*.wav --genre pop # faders that put stems on a genre balance ferraus master mix.wav --target streaming # release-ready master at -14 LUFS

Editing and conversion: convert, trim, cut, split, concat, resample, normalize (EBU R128), channels, silence, tags, waveform and spectrogram export; audio from MP4/MKV/WebM/MOV.
Effects: fades, compressor, limiter, gate, de-esser, multiband, EQ, reverb (plate, FDN, convolution), delay, chorus/flanger/phaser, saturation, vocoder, panning and automation.
Restoration matching Adobe Audition's effects: declip, dehum, declick, dehiss, spectral repair, phase alignment, leveler, scientific filters, and more.
Noise reduction from a noise profile, adaptive, or model-based (DeepFilterNet, RNNoise).
Stem separation in tiers from Demucs to RoFormer ensembles.
Pitch and time: auto-tune, pitch shift with formant preservation, time stretch.
MIDI and notation: quantize, groove, hum-to-MIDI, rendering through SoundFonts, SFZ, or CLAP/VST3 instruments; scores (lead sheet, grand staff, drums, solfa) from audio or MIDI, and sheet-music PDFs performed as audio.
Mixing: stem balance to genre templates, level-aware masking analysis with the EQ cut that fixes it, sidechain ducking, a vocal rider that holds the vocal against the music word by word, dynamic resonance control, song structure (sections, repeats, roles), patching a bad note from a clean repeat, a pass/fail gate before mastering, and whole sessions as cached pipeline files whose stages report their own measurements.
Mastering: one command, or an analyze → plan → verify loop an agent can drive.

For AI agents

Every command takes --json and returns a stable, versioned envelope; ferraus schema prints its JSON Schema; every output gets a provenance sidecar ( .ferraus.json) that ferraus replay reproduces. ferraus is also an MCP server:

claude mcp add ferraus -- ferraus mcp serve --allow ~/music

ferraus describe --agent prints the whole command surface in under 4,000 tokens. See AGENTS.md.

Install the skills

The ferraus skill teaches an agent when and how to use ferraus (the --json contract, dry runs, model downloads). The companion skills carry an engineer's working method for whole jobs: every decision taken from a measurement, every result checked against a numeric gate, and the session delivered as an editable pipeline file plus a report. They are what let an agent mix and master a producer's stems unsupervised.

Skill	What it does
`ferraus`	the CLI contract and the common one-command tasks; routes to the others
`ferraus-mix`	stems → balanced, processed, panned mix with sends, ducking, and a pass/fail gate before mastering
`ferraus-master`	mix → reviewed and verified masters for every destination, deliverables, albums, alternate versions
`ferraus-vocals`	raw take → repaired, tuned, produced vocal; doubles and vocal effects
`ferraus-mix-review`	measured, prioritized notes on a mix or master; reference and version comparisons
`ferraus-stems`	stem export checks, separation, instrumental/a cappella/TV versions, remix prep
`ferraus-beats`	drum patterns, chords, bass lines as DAW-ready MIDI, rendered to audition

Install them with one of:

Agent	Command
Claude Code	`claude plugin marketplace add djynnius/ferraus`, then `claude plugin install ferraus@ferraus` (all skills)
Other agents (Cursor, Codex, Gemini CLI, …)	`npx skills add djynnius/ferraus`, then pick the skills and your agent
Any agent, by hand	copy the folders under `skills/` into the agent's skills folder

The skills drive the ferraus command, so install the CLI first (see Install).

One prompt that sets everything up

To set up an agent, paste this into it:

Install the ferraus CLI and its skill, then use ferraus for any audio, music, or sheet-music task.

Install the CLI if ferraus --version fails. Use one method: macOS or Linux with Homebrew: brew install djynnius/tap/ferraus; otherwise on macOS or Linux: curl -fsSL https://github.com/djynnius/ferraus/releases/latest/download/ferraus-installer.sh | sh; on Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://github.com/djynnius/ferraus/releases/latest/download/ferraus-installer.ps1 | iex". Then run ferraus doctor --json and confirm "ok": true.
Install the skills. In Claude Code: claude plugin marketplace add djynnius/ferraus, then claude plugin install ferraus@ferraus. In another agent: npx skills add djynnius/ferraus and select all the ferraus skills and your agent. Use one method. You can read the skills directly at https://github.com/djynnius/ferraus/tree/main/skills (the main one, raw: https://raw.githubusercontent.com/djynnius/ferraus/main/skills/ferraus/SKILL.md).
Optional, if you support MCP: register ferraus mcp serve --allow as an MCP server (Claude Code: claude mcp add ferraus -- ferraus mcp serve --allow ~/Music).
Before the first task, run ferraus describe --agent for the command catalog and read https://raw.githubusercontent.com/djynnius/ferraus/main/AGENTS.md for the contract: add --json to every call, plan with --dry-run, never pass --overwrite unless asked, and only download models (-y) when the user agrees.

Examples

examples/ has runnable shell scripts, pipeline files, an MCP client, and a Claude agent loop. They work on test audio that ferraus generates, and CI runs all of them.

Install

Platform	Command
macOS and Linux	`curl -fsSL https://github.com/djynnius/ferraus/releases/latest/download/ferraus-installer.sh \	sh`
Windows (PowerShell)	`powershell -ExecutionPolicy ByPass -c "irm https://github.com/djynnius/ferraus/releases/latest/download/ferraus-installer.ps1 \	iex"`
Homebrew	`brew install djynnius/tap/ferraus`
Debian 13+ / Ubuntu 24.04+	the apt repository below, or the `.deb` from the releases page
Fedora 39+ / RHEL	`sudo curl -fsSLo /etc/yum.repos.d/ferraus.repo https://djynnius.github.io/packages/rpm/ferraus.repo && sudo dnf install ferraus`
Windows (scoop)	`scoop bucket add djynnius https://github.com/djynnius/scoop-bucket; scoop install djynnius/ferraus`
Windows (MSI)	from the releases page
Docker	`docker run --rm -v "$PWD:/work" -v ferraus-data:/data ghcr.io/djynnius/ferraus info song.wav`
From source	`cargo install ferraus`

apt repository (signed; updates arrive with apt upgrade):

sudo mkdir -p /etc/apt/keyrings

sudo curl -fsSLo /etc/apt/keyrings/ferraus-archive-keyring.asc https://djynnius.github.io/packages/ferraus-archive-keyring.asc sudo curl -fsSLo /etc/apt/sources.list.d/ferraus.sources https://djynnius.github.io/packages/apt/ferraus.sources sudo apt update && sudo apt install ferraus

Update: ferraus update --check says whether a newer release is out and how to get it; ferraus update installs it when the release installer put ferraus there, and otherwise prints the Homebrew, apt, dnf, scoop, or cargo command.

Builds: macOS 13.4+ on Apple silicon and Intel; Linux on x86-64 and ARM64, both with glibc 2.38+ (Ubuntu 24.04+, Debian 13+, Fedora 39+) and as a fully static musl build for Alpine and older distributions (the shell installer picks it when glibc is too old; it cannot load CLAP or VST3 plugins); Windows on x86-64 and ARM64 (needs the Microsoft Visual C++ Redistributable, present on most machines). Release artifacts are built and attested only by this repository's GitHub Actions workflows. Model weights are not in the package; they download on first use (with -y or models.auto_download = true) and are verified by SHA-256.

Run ferraus doctor after installing.

Documentation

ferraus docs — the full reference page for any command, offline.
The docs site: https://djynnius.github.io/ferraus (and llms.txt for models).
Product requirements.md), architecture decisions, contributor guide.

License

Apache-2.0 OR MIT, at your option. The score engraving helper (ferraus-engrave) is LGPL-3.0 because it links Verovio; it runs as a separate process.

ferraus

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“设计、图片与音频”中的其他服务器比较i

常见问题

替代选择

Figma Context MCP

Claude Real Video

Figma MCP Server

作者的 README

ferraus

For AI agents

Install the skills

One prompt that sets everything up

Examples

Install

Documentation

License