FP

fadelabs/phantom

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

44 stars 2 forks Качество 65 Тренд 33NOASSERTION

Аудиоинженерная система AI: навыки MCP-сервера + Claude Code для профессионального автоматизированного смешивания и овладения

Обзор

Phantom измеряет звук и дает помощнику ИИ доказательства для работы. Проанализируйте смесь или папку стеблей, сравните ее со ссылкой и исследуйте громкость, тональный баланс, стереоповедение, фазовую и частотную маскировку. Используйте его в качестве инструмента командной строки, библиотеки Python или сервера MCP. Плагин Claude Code добавляет пять навыков для интерпретации измерений и планирования комбинации. Отдельные интеграции Reaper и Ableton MCP позволяют помощнику работать внутри вашего DAW. Документация · Начало работы · Ссылка на инструмент · Выпуски Phantom поддерживает macOS и Linux с Python 3.10-3.13. Приведенные ниже команды используют 3.13. Зависимость от Essentia не имеет колеса Windows. Замена бэкэнда отслеживается в выпуске #52. CLI работает без помощника ИИ. Первое использование может запускать настройку для настройки MCP-сервера и плагина Claude Code; вы также можете запускать фантомную настройку явно. Для ассистента попробуйте: «Проанализируйте эти стебли.

Обзор (машинный перевод)

Phantom измеряет звук и дает помощнику ИИ доказательства для работы. Проанализируйте смесь или папку стеблей, сравните ее со ссылкой и исследуйте громкость, тональный баланс, стереоповедение, фазовую и частотную маскировку.

Используйте его в качестве инструмента командной строки, библиотеки Python или сервера MCP. Плагин Claude Code добавляет пять навыков для интерпретации измерений и планирования комбинации. Отдельные интеграции Reaper и Ableton MCP позволяют помощнику работать внутри вашего DAW.

Документация · Начало работы · Ссылка на инструмент · Выпуски

Начните с одного файла

Phantom поддерживает macOS и Linux с Python 3.10-3.13. Приведенные ниже команды используют 3.13. **Windows не поддерживается: ** В зависимости от Essentia нет колеса Windows. Замена бэкэнда отслеживается в выпуске #52.

Установите uv, затем:

CLI работает без помощника ИИ. Первое использование может запускать настройку для настройки MCP-сервера и плагина Claude Code; вы также можете запускать phantom setup явно.

Для ассистента попробуйте: «Проанализируйте эти стебли. Расставьте приоритеты технических проблем, объясните измерения и скажите мне, что бы вы проверяли, слушая, прежде чем что-либо менять».

Что можно сделать

** Проверьте запись перед сведением.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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
Открыть полный README на GitHub

Установка

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

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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