FP

fadelabs/phantom

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

44 stars 2 forks 质量 65 趋势 33NOASSERTION

AI音频工程系统:MCP服务器+Claude代码技能,用于专业自动混音和母带处理

概览

Phantom 测量音频,并提供 AI 助手的证据供参考。分析混音或一文件夹的音轨,与参考资料进行比较,研究响度、音色平衡、立体声行为、相位和频率掩蔽。 可以用作命令行工具、Python 库或 MCP 服务器。Claude Code 插件增加了五项技能,用于解读测量和规划混音。独立的 Reaper 和 Ableton MCP 集成让助手能在你的数字音频工作站内工作。 文档 ·入门指南 ·工具参考 ·发布 Phantom 支持 macOS 和 Linux 的 Python 3.10–3.13。以下命令使用 3.13。Essentia 依赖没有 Windows 轮。在第 #52 期中追踪了一个替代后端。 CLI 无需 AI 助手即可工作。首次使用时可以运行设置来配置 MCP 服务器和 Claude Code 插件;你也可以显式运行幻影设置。 对于助手,试试:“分析这些茎。

概述(AI 翻译)

Phantom 测量音频,并提供 AI 助手的证据供参考。分析混音或一文件夹的音轨,与参考资料进行比较,研究响度、音色平衡、立体声行为、相位和频率掩蔽。

可以用作命令行工具、Python 库或 MCP 服务器。Claude Code 插件增加了五项技能,用于解读测量和规划混音。独立的 Reaper 和 Ableton MCP 集成让助手能在你的数字音频工作站内工作。

文档 ·入门指南 ·工具参考 ·发布

从一个文件开始

Phantom 支持 macOS 和 Linux 的 Python 3.10–3.13。以下命令使用 3.13。不支持 Windows: Essentia 依赖没有 Windows 轮子。在第 #52 期中追踪到替代后端。

安装UV,然后:

CLI 无需 AI 助手即可运行。首次使用时可以运行设置来配置 MCP 服务器和 Claude Code 插件;你也可以显式运行 phantom setup。

对于助理,可以试试:“分析这些音轨。优先处理技术问题,解释测量结果,并在修改前告诉我你会通过倾听检查什么。”

你能做什么

  • **混音前请检查录音。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Phantom

Phantom measures audio and gives an AI assistant evidence to work with. Analyze a mix or a folder of stems, compare it with a reference, and investigate loudness, tonal balance, stereo behavior, phase, and frequency masking.

Use it as a command-line tool, a Python library, or an MCP server. The Claude Code plugin adds five skills for interpreting the measurements and planning a mix. Separate Reaper and Ableton MCP integrations let an assistant work inside your DAW.

Documentation · Getting started · Tool reference · Releases

Start with one file

Phantom supports macOS and Linux with Python 3.11–3.13. The commands below use 3.13. Windows is not supported: the Essentia dependency has no Windows wheel. A replacement backend is tracked in issue #52.

Install uv, then:

uv tool install phantom-audio --python 3.13
phantom analyze mix.wav
phantom analyze mix.wav --json
phantom compare mix.wav --reference reference.wav
phantom doctor

The CLI works without an AI assistant. First use may run setup to configure the MCP server and Claude Code plugin; you can also run phantom setup explicitly.

For an assistant, try: “Analyze these stems. Prioritize technical problems, explain the measurements, and tell me what you would check by listening before changing anything.”

What you can do

  • Check a recording before mixing. Look for digital clipping, DC offset, mains hum, noise, and stereo polarity problems. Batch diagnostics also report differing sample rates.
  • Compare a mix with a reference. Measure loudness, relative octave-band balance, dynamics, and stereo differences. Nine genre profiles provide starting targets when you do not have a reference file.
  • Find competing stems. Rank pairs by weighted octave-band overlap to decide where to investigate masking. The score is a heuristic; it does not establish that one instrument is inaudible.
  • Try corrective processing. With the processing extra, apply EQ and other Pedalboard operations or use recipes for selected detected problems. fix_audio reports before/after findings, including regressions.
  • Read meters from Phantom Studio. read_live_metrics reads local snapshots from the separate Studio preview plugin. Studio is not included in this package.

The measurements support an engineering decision. They cannot decide whether distortion is intentional, whether a reference suits a song, or whether a change sounds better.

Analysis tools

The MCP server exposes 20 tools over stdio:

Purpose Tools
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "phantom": { "command": "phantom-mcp", "args": [] } } }