rubin (Amamparo)

鲁宾

一个MCP服务器，用于监听音频并提供有关混音质量、音色兼容性和风格连贯性的结构化反馈。

快速开始

# Install
poetry install

# Run the MCP server (default: system audio capture)
poetry run rubin

# Or via Docker
docker run --rm -it aaronmamparo/rubin:latest

音频设置

Rubin需要音频路由到它。选择适合您设置的选项：

选项A：系统音频捕获（推荐）

将您的系统或DAW音频路由到虚拟环回设备，然后将Rubin指向该设备。

macOS-- 黑洞

brew install blackhole-2ch

1. 打开 音频MIDI设置 → 创建一个 多输出设备 组合扬声器+黑洞2ch
2. 将多输出设置为系统输出（或DAW的输出）
3. 鲁宾瞄准黑洞：

RUBIN_AUDIO_DEVICE="BlackHole 2ch" poetry run rubin

窗户-- VB音频虚拟电缆

1. 安装VB-CABLE
2. 将DAW或系统输出设置为 电缆输入
3. 让鲁宾瞄准虚拟有线电视：

set RUBIN_AUDIO_DEVICE=CABLE Output
poetry run rubin

Linux-PulseAudio/PipeWire

# Create a virtual sink and loopback
pactl load-module module-null-sink sink_name=rubin sink_properties=device.description=Rubin
pactl load-module module-loopback source=rubin.monitor

# Route your DAW output to the "Rubin" sink, then:
RUBIN_AUDIO_DEVICE="Rubin" poetry run rubin

选项B:TCP套接字

通过TCP发送原始PCM音频。适用于远程源或自定义管道。

# Start Rubin in TCP mode
poetry run rubin --audio tcp --tcp-port 9878

# From another terminal, pipe audio via ffmpeg:
ffmpeg -i your_track.wav -f f32le -ac 2 -ar 44100 - | \
  nc localhost 9878

选项C：标准管

通过标准输入直接传输音频。非常适合一次性分析。

ffmpeg -i your_track.wav -f f32le -ac 2 -ar 44100 - | \
  poetry run rubin --audio stdin

Claude桌面设置

将Rubin添加到您的 claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

选项A：从GitHub运行（不需要克隆）

最简单的设置——使用以下命令直接从仓库运行Rubin uvx:

{
  "mcpServers": {
    "rubin": {
      "command": "/absolute/path/to/uvx",
      "args": ["--from", "git+https://github.com/aaronmamparo/rubin", "rubin"],
      "env": {
        "RUBIN_AUDIO_DEVICE": "BlackHole 2ch"
      }
    }
  }
}

找到你的uvx路径 which uvx。路径必须是绝对路径——Claude Desktop不继承shell的path。

选项B：本地克隆（诗歌）

如果您已在本地克隆了仓库：

{
  "mcpServers": {
    "rubin": {
      "command": "/absolute/path/to/poetry",
      "args": ["--directory", "/absolute/path/to/rubin", "run", "rubin"],
      "env": {
        "RUBIN_AUDIO_DEVICE": "BlackHole 2ch"
      }
    }
  }
}

找到你的诗歌之路 which poetry。两条路径都必须是绝对的。

选项C:Docker（仅限TCP/stdin）

注： Docker容器无法访问主机音频设备（BlackHole/VB audio）。使用选项A或B进行系统音频捕获。

{
  "mcpServers": {
    "rubin": {
      "command": "/usr/local/bin/docker",
      "args": ["run", "--rm", "-i", "-e", "RUBIN_AUDIO_MODE=tcp", "aaronmamparo/rubin:latest"]
    }
  }
}

保存后重新启动Claude Desktop。您应该在输入栏中看到Rubin工具（锤子图标）。然后，克劳德可以评估你的混音，捕捉快照，并提出调整建议——只要让它听就行了。

MCP工具

样式配置文件

内置配置文件

16个内置配置文件，涵盖广泛的流派：

自定义样式

通过与克劳德的自然对话创造自己的风格——只需描述你想要的声音：

“用温暖的低音、闪闪发光的高音和宽广的立体声创造梦幻流行风格”

自定义样式保存到 ~/.rubin/styles/ 并在会话中持续存在。您也可以以相同的方式更新或删除它们。

要手动创建样式，请将JSON文件添加到 ~/.rubin/styles/:

{
  "name": "my-style",
  "description": "Description of the target sound",
  "frequency_balance": {
    "sub_bass": { "low": 0.001, "high": 0.05 },
    "bass": { "low": 0.005, "high": 0.08 },
    "low_mid": { "low": 0.003, "high": 0.06 },
    "mid": { "low": 0.002, "high": 0.04 },
    "upper_mid": { "low": 0.001, "high": 0.025 },
    "presence": { "low": 0.0005, "high": 0.02 },
    "brilliance": { "low": 0.0005, "high": 0.015 }
  },
  "dynamic_range_db": { "low": 10, "high": 30 },
  "brightness": { "low": 1000, "high": 3000 },
  "stereo_width": { "low": 0.15, "high": 0.5 },
  "rms_mean": { "low": 0.01, "high": 0.12 }
}

发展

just install    # install dependencies
just check      # lint + test
just fmt        # auto-format
just test       # run tests only

码头工人

docker build -t rubin .
docker run --rm -it rubin --audio tcp --tcp-port 9878