AudacityMCP

AudacityMCP подключает любого MCP-совместимого AI-ассистента к Audacity, давая ему полный контроль над редактированием звука через 144 инструмента, охватывающих эффекты, очистку, мастеринг, транскрипцию и многое другое. Общайтесь со своим AI-ассистентом — и он редактирует ваш звук в реальном времени.

Никакого облака. Никаких API-ключей для обработки звука. Всё работает локально через именованный канал Audacity.

Если этот проект вам полезен, звезда поможет другим найти его — это весь маркетинговый бюджет проекта. Хотите помочь поддерживать его? Нажмите на бейдж Sponsor сверху.

Совместимость: AudacityMCP в настоящее время работает только с Audacity 3.x. Audacity 4.x пока не поддерживается — надеемся добавить поддержку в будущем.

Работает с

AudacityMCP работает с любым AI-клиентом, поддерживающим Model Context Protocol:

• Claude Desktop — десктопное приложение Anthropic

• Claude Code — CLI-агент

• Cursor — AI-редактор кода с поддержкой MCP

• Любой другой MCP-совместимый клиент

Быстрый старт

1. Получите AudacityMCP

Вариант A: Нажмите зелёную кнопку Code выше → Download ZIP → распакуйте в папку

Вариант B: Клонируйте через git:

git clone https://github.com/xDarkzx/Audacity-MCP.git

2. Запустите установщик (настроит всё остальное автоматически)

Windows: дважды щёлкните install.bat в Проводнике, или — если вы уже в терминале после шага git clone — просто продолжайте в том же окне PowerShell/Command Prompt:

cd Audacity-MCP
.\install.bat

macOS / Linux:

cd Audacity-MCP
bash install.sh

Установщик делает 3 вещи: устанавливает audacity-mcp из этой локальной папки (той, что вы только что скачали/клонировали — без обращения к PyPI или GitHub), включает mod-script-pipe в Audacity и настраивает Claude Desktop — ручное редактирование JSON не требуется. Он запрашивает подтверждение перед изменением любого из конфигурационных файлов, сначала объясняет, что именно собирается сделать, и всегда создаёт резервную копию существующего файла перед его изменением. Хотите увидеть всё, что он сделает, ничего не меняя? Добавьте --dry-run: .\install.bat --dry-run / bash install.sh --dry-run.

Примечание: install.bat/install.sh должны запускаться из этой папки — они устанавливают только код, находящийся рядом с ними, и сами ничего не скачивают.

Если вы не используете Claude Desktop, установите вручную с помощью pip install audacity-mcp-server и добавьте в MCP-конфиг вашего клиента:

{
  "mcpServers": {
    "audacity": {
      "command": "audacity-mcp"
    }
  }
}

Проверьте документацию вашего клиента по MCP, чтобы узнать расположение файла конфигурации.

Клиент не может найти/запустить audacity-mcp? GUI-приложения не всегда видят тот же PATH, что и терминал. Выполните python -c "import sysconfig; print(sysconfig.get_path('scripts'))" и используйте полный путь, который он выведет (плюс \audacity-mcp.exe на Windows или /audacity-mcp на macOS/Linux), в качестве "command" вместо голого имени.

Никаких install.bat/install.sh, ничего, что автоматически трогает вашу систему — три шага, всё вручную:

1. Включите mod-script-pipe в Audacity: Правка → Настройки (Windows/Linux) или Audacity → Настройки (macOS) → Модули → установите mod-script-pipe в положение Enabled → OK → перезапустите Audacity.

2. Установите пакет: откройте терминал (Command Prompt/PowerShell на Windows, Terminal на macOS/Linux) и выполните pip install audacity-mcp-server — обычная установка из PyPI, клонирование репозитория не требуется.

3. Настройте Claude Desktop: откройте Claude Desktop → Settings (значок шестерёнки) → вкладка Developer → Edit Config — откроется claude_desktop_config.json в текстовом редакторе. Добавьте это внутрь блока "mcpServers", сохранив все остальные серверы, которые у вас уже есть:

   {
     "mcpServers": {
       "audacity": {
         "command": "audacity-mcp"
       }
     }
   }

   Сохраните файл и полностью перезапустите Claude Desktop (выйдите из системного трея, а не просто закройте окно).

Это вся установка — см. Руководство по установке для тех же шагов с большими подробностями и примечаниями для каждой ОС.

"audacity" не появляется как инструмент после перезапуска? "command": "audacity-mcp" выше работает только в том случае, если эта команда находится в том же PATH, который использует сам Claude Desktop, а это не всегда так (особенно если Claude Desktop был уже открыт, когда вы установили Python). Если подключение не происходит, выполните в терминале эту команду, чтобы найти реальное расположение установки: python -c "import sysconfig; print(sysconfig.get_path('scripts'))" — затем замените "audacity-mcp" выше на полный путь, который она выведет, плюс \audacity-mcp.exe (Windows, не забудьте удвоить каждый обратный слэш: \\) или /audacity-mcp (macOS/Linux).

3. Начните редактирование

Откройте Audacity, загрузите аудио и общайтесь со своим AI:

"Clean up this podcast recording"
"Master this track for Spotify, it's EDM"
"Transcribe this and add labels at each sentence"
"Add reverb with a large room, then export as FLAC"

Audacity должен быть открыт заранее. AudacityMCP общается через именованный канал Audacity — он не может запустить Audacity за вас.

Полное Руководство по установке содержит подробные инструкции для всех платформ и MCP-клиентов.

Related MCP server: ReaperMCP

Зачем AudacityMCP?

Без AudacityMCP: Вы вручную перемещаетесь по меню, подбираете параметры эффектов на слух, применяете эффекты по одному, ищете спецификации ACX и повторяете, пока не зазвучит правильно.

С AudacityMCP: Вы описываете желаемый результат простым языком, а AI делает всё остальное — подбирает нужные эффекты, устанавливает профессиональные параметры и объединяет операции в цепочки.

AudacityMCP особенно полезен для:

• Подкастеров, которым нужен стабильный профессиональный звук без знаний звукорежиссуры

• Музыкантов, которым нужен быстрый мастеринг с настройками под жанр

• Создателей контента, работающих с интервью, озвучкой или полевыми записями

• Всех, кто предпочитает описать желаемый результат, а не кликать по меню

Что он умеет?

You:  "Clean up this podcast recording"
AI:   Runs auto_cleanup_podcast → HPF 80Hz → noise reduction → compression → safe loudness check

You:  "Master this track for Spotify, it's EDM"
AI:   Runs auto_master_music style=edm → HPF 30Hz → click removal → compression 2.5:1 → bass +2dB → loudness check

You:  "This is a noisy live recording, fix it up"
AI:   Runs auto_cleanup_live → HPF 100Hz → click removal → noise reduction 18dB → compression 5:1

You:  "Transcribe this interview and add labels"
AI:   Runs transcribe_to_labels → faster-whisper transcription → Audacity labels at each timestamp

You:  "Add reverb to the vocals, then export as FLAC"
AI:   select region → reverb effect → export to FLAC

Возможности

144 инструмента в 11 категориях

Конвейеры

AudacityMCP включает 9 конвейеров в один клик для типовых аудиозадач. Каждый конвейер спроектирован так, чтобы быть безопасным для плохо записанного аудио — он никогда не усилит ваш звук до опасного уровня. Конвейеры очищают и улучшают ваш звук, после чего вы можете вручную отрегулировать громкость при необходимости.

Как работают пайплайны

1. Вы говорите ИИ, что вам нужно (например, «почистить этот подкаст»)

2. ИИ выбирает подходящий пайплайн и запускает его

3. Пайплайн работает в фоне — вы получаете job_id

4. Опрашивайте check_pipeline_status каждые 15–30 секунд, чтобы отслеживать прогресс

5. Когда готово, в Audacity появляется всплывающее окно

Правило безопасности: Пайплайны только снижают пики, если они слишком горячие. Они никогда не усиливают громкость. Если вы хотите достичь конкретного целевого значения LUFS (например, -14 для Spotify), попросите ИИ запустить loudness_normalize после того, как проверите, что результаты выглядят хорошо.

Справочник пайплайнов

auto_analyze_audio — Анализ перед обработкой

Измеряет ваш звук и рекомендует лучший пайплайн. Запустите это первым, если не уверены, что делать.

You: "Analyze this audio"
→ Returns: peak level, noise floor, clipping status, recommended pipeline

auto_cleanup_audio — Только безопасная очистка

Убирает шум и артефакты без изменения громкости вообще. Используйте, когда уровни уже в порядке.

You: "Just clean up the noise, don't change the volume"
→ DC offset removal → HPF 80Hz → noise reduction → click removal (optional)

auto_cleanup_podcast — Подкаст / озвучка

Профессиональная вещательная обработка для устной речи.

You: "Clean up this podcast recording"
→ DC offset → HPF 80Hz → noise reduction 12dB → compression 3:1 → safe loudness check

auto_audiobook_mastering — Аудиокнига (ACX/Audible)

Ориентирован на требования ACX для распространения аудиокниг.

You: "Master this for ACX / Audible"
→ DC offset → HPF 80Hz → noise reduction 12dB → compression 2.5:1 → safe loudness check → peak cap -3dB

auto_cleanup_interview — Интервью / диалог

Лёгкая обработка для разговоров — сохраняет естественную динамику.

You: "Clean up this interview recording"
→ DC offset → HPF 80Hz → noise reduction 8dB → compression 2.5:1 → safe loudness check

auto_cleanup_vocal — Вокал / студийный вокал

Настроен для вокальных записей с эквалайзером присутствия для чёткости.

You: "Process this vocal recording"
→ DC offset → HPF 100Hz → noise reduction 10dB → compression 3:1 → presence EQ (+3dB treble, -1dB bass) → safe loudness check

auto_cleanup_live — Живая / полевая / шумная запись

Агрессивная очистка для шумных сред. Первые 0,5 с должны содержать фоновый шум для профилирования.

You: "This is a noisy live recording, clean it up"
→ DC offset → HPF 100Hz → click removal → noise reduction 18dB → compression 5:1 → safe loudness check

auto_master_music — Мастеринг музыки

Мастеринг с настройкой под жанр, 6 пресетов: edm, hiphop, rock, pop, classical, acoustic.

You: "Master this hip-hop track"
→ HPF 30Hz → click removal → compression 2:1 → bass +3dB treble +1dB → safe loudness check

You: "Master this for a classical album"
→ HPF 30Hz → click removal → compression 1.3:1 (very gentle) → no EQ → safe loudness check

auto_lofi_effect — Креативный lo-fi / винтаж

Применяет тёплый винтажный lo-fi звук. Пресеты: light, medium, heavy.

You: "Give this a lo-fi vibe"
→ HPF → LPF (muffled highs) → bass/treble warmth → compression 2:1 → safe loudness check

После пайплайна: настройка громкости

Пайплайны намеренно не трогают громкость (они только снижают пики, если есть клиппинг). Чтобы достичь целевого значения для стриминга:

You: "Now normalize this to -14 LUFS for Spotify"
→ AI uses loudness_normalize tool with lufs_level=-14

You: "Normalize to -16 LUFS for podcast"
→ AI uses loudness_normalize tool with lufs_level=-16

Почему не делать это автоматически? Нормализация LUFS может усилить тихие/плохо записанные аудио на 10–20 дБ, что испортит звук. Разделяя очистку и громкость, вы можете проверить результаты перед финальным шагом громкости.

Локальная транскрипция (экспериментально)

Эта функция экспериментальна и требует отдельной настройки. Всё остальное работает без неё.

Работает на faster-whisper — полностью офлайн, ваш звук никогда не покидает ваше устройство:

• 5 размеров моделей: tiny, base, small, medium, large-v3

• Транскрипция всего аудио или только выделения

• Экспорт в SRT, VTT или обычный текст субтитров

• Автоматическое добавление меток Audacity на каждом речевом сегменте

• Определение языка или указание 99+ языков

Требуется настройка перед первым использованием: См. Настройка транскрипции для шагов установки.

Хотите ускорение GPU (в 10–20 раз быстрее)? Запустите audacity-mcp-setup-gpu — или скачайте setup_gpu.bat/setup_gpu.sh и дважды щёлкните/запустите его, если не хотите использовать терминал. Определяет ваш GPU, устанавливает необходимое и проверяет, что всё работает. Только NVIDIA GPU (графика AMD/Intel и macOS вообще не поддерживаются бэкендом транскрипции — подойдёт любая карта NVIDIA, GeForce не обязательна, достаточно наличия NVIDIA GPU). Нет NVIDIA GPU? CPU работает нормально, просто медленнее на длинных файлах.

Скрипт говорит, что всё работает, но транскрипция всё ещё медленная/на CPU? Это значит, что Claude Desktop запускает audacity-mcp из другого Python, чем тот, который проверил скрипт — см. исправление (ручная правка конфига, пять минут).

Что нового — v0.1.3

32 новых инструмента (99 → 131), исправления настройки пайплайнов и проверено вживую с Audacity.

• Новые эффекты: Reverse, Invert, Repair, AutoDuck, NotchFilter, VocalReduction, AdjustableFade, StudioFadeOut, CrossfadeClips, CrossfadeTracks, ClipFix, SlidingStretch, Tremolo

• Новое редактирование: Split (на месте), SplitCut, SplitDelete, Disjoin + переименован старый split → edit_split_new

• Новые дорожки: StereoToMono, MixAndRenderToNew, MuteAll, UnmuteAll, Resample, AlignEndToEnd, AddLabelTrack

• Новый выбор: CursorToTrackStart/End, CursorToProjectStart/End, SelectCursorToTrackEnd

• Новый проект: EditMetadata, ImportMIDI

• Новые метки: RegularIntervalLabels

• Исправления пайплайнов: ACX пиковый предел -3.0→-3.5 дБ, live NR 18→12 дБ, подкаст компрессия 10 мс/1 с→30 мс/200 мс, интервью release 1 с→200 мс

• Исправление ошибок: effect_repair теперь использует длинный таймаут (Audacity показывает всплывающее окно при недопустимом выделении)

• Проверка: Добавлены недостающие проверки диапазонов для AutoDuck, VocalReduction, SlidingStretch, Resample

Устранение неполадок

mod-script-pipe не включен

Установщик включает это автоматически, но если не сработало (например, Audacity никогда не открывался), включите вручную:

1. Откройте Audacity

2. Перейдите в Правка → Настройки (Windows/Linux) или Audacity → Настройки (macOS)

3. Нажмите Модули на левой боковой панели

4. Установите mod-script-pipe в Включено

5. Нажмите OK и перезапустите Audacity

Проблемы с подключением

Проблемы с пайплайнами

Советы по качеству звука

Общие проблемы

Архитектура

┌──────────────┐     stdio      ┌──────────────┐   named pipe   ┌──────────────┐
│  MCP Client  │◄──────────────►│ AudacityMCP  │◄──────────────►│   Audacity   │
│(AI assistant)│    (JSON-RPC)  │   FastMCP    │  (commands)    │              │
└──────────────┘                └──────────────┘                └──────────────┘
                                       │
                                       ├── audacity_mcp/main.py          (entry point)
                                       ├── audacity_mcp/audacity_client.py (pipe I/O)
                                       ├── audacity_mcp/tool_registry.py  (auto-loader)
                                       └── audacity_mcp/tools/            (11 modules)

Ключевые проектные решения

• Именованные каналы, а не TCP — Прямой IPC к mod-script-pipe Audacity. Нет сетевого доступа, нет конфликтов портов.

• Ноль exec/eval — Каждая операция сопоставляется со статическим обработчиком с проверкой входных данных. Нет произвольного выполнения кода.

• Кроссплатформенность — Windows использует Win32 API через ctypes, Unix — стандартный файловый ввод/вывод.

• Асинхронность везде — Все обработчики инструментов являются async. Блокирующий ввод/вывод каналов выполняется в пуле исполнителей с настраиваемыми тайм-аутами.

• Безопасные конвейеры — Конвейеры измеряют аудио перед принятием решений о громкости. Они только уменьшают, никогда не усиливают.

• Динамическая регистрация инструментов — Поместите модуль в audacity_mcp/tools/, экспортируйте функцию register(mcp), и он будет автоматически обнаружен.

Структура проекта

AudacityMCP/
├── audacity_mcp/
│   ├── main.py                 # FastMCP server entry point
│   ├── audacity_client.py      # Cross-platform named pipe client
│   ├── tool_registry.py        # Auto-discovers and registers tool modules
│   └── tools/
│       ├── analysis_tools.py   # Audio analysis (contrast, spectrum, beats)
│       ├── cleanup_tools.py    # Noise reduction, mastering, 9 pipelines
│       ├── edit_tools.py       # Cut, copy, paste, split, join, trim
│       ├── effects_tools.py    # Reverb, echo, pitch, EQ, filters
│       ├── generate_tools.py   # Tone, noise, chirp, DTMF generation
│       ├── label_tools.py      # Label management
│       ├── project_tools.py    # Project/file operations
│       ├── selection_tools.py  # Selection and cursor control
│       ├── track_tools.py      # Track management
│       ├── transcription_tools.py  # Whisper-based transcription
│       └── transport_tools.py  # Playback and recording control
├── audacity_mcp_shared/
│   ├── constants.py            # Pipe paths, timeouts, allowed formats
│   ├── error_codes.py          # Typed error codes (pipe/command/validation)
│   └── pipe_protocol.py        # Command formatting and response parsing
├── tests/                      # 60 tests
├── docs/
│   ├── INSTALLATION.md         # Detailed setup guide
│   └── TOOLS.md                # Complete tool reference
└── pyproject.toml

Разработка

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/ -x -q

# Run lint (real bugs + security patterns, not style/formatting)
ruff check .

Добавление новых инструментов

1. Создайте модуль в audacity_mcp/tools/ (или добавьте в существующий)

2. Экспортируйте функцию register(mcp: FastMCP)

3. Определите свои инструменты с помощью декораторов @mcp.tool()

4. Всё — реестр инструментов автоматически обнаружит его при запуске

# audacity_mcp/tools/my_tools.py
from mcp.server.fastmcp import FastMCP
from audacity_mcp_shared.error_codes import AudacityMCPError, ErrorCode


def register(mcp: FastMCP):
    from audacity_mcp.main import client

    @mcp.tool()
    async def my_custom_effect(intensity: float = 0.5) -> dict:
        """Apply my custom effect to the selected audio."""
        if not 0 <= intensity <= 1:
            raise AudacityMCPError(ErrorCode.VALUE_OUT_OF_RANGE, "intensity must be 0-1")
        return await client.execute_long("MyEffect", Intensity=intensity)

Полные рекомендации см. в CONTRIBUTING.md.

Сообщество

Превратить это в инструмент, к которому обращается каждый пользователь Audacity, под силу не одному человеку. Если вы используете AudacityMCP — даже просто пробуете его — заходите в Discord: делитесь тем, что создали, сообщайте о неисправностях, предлагайте недостающее или просто общайтесь с другими людьми, занимающимися редактированием аудио с помощью ИИ. Сообщества растут, когда один человек рассказывает другому о существовании проекта, поэтому, если вы знаете кого-то, кому это может быть полезно, отправьте им ссылку.

Поддержка

Если AudacityMCP сэкономил вам время или помог в ваших аудиопроектах, подумайте о спонсорстве:

Ваша поддержка помогает поддерживать этот проект и сохранять его бесплатным для всех.

Документация

• Руководство по установке — Подробная настройка для Windows, macOS, Linux

• Справочник по инструментам — Полный справочник по всем 144 инструментам с параметрами и диапазонами

• Редактирование на основе транскрипта — Руководство по рабочему процессу для подкастов, интервью и лекций (редактирование на основе меток)

• Участие — Как добавлять инструменты и вносить вклад

• Журнал изменений — История версий и примечания к выпускам

Благодарности

Спасибо следующим людям за сообщённые ошибки, идеи и отзывы, которые улучшили этот проект:

• @Harsha-Jay-S — диагностировал ошибку effect_change_pitch/effect_change_speed (#15) с измеренными доказательствами на реальном Audacity, точно указав корневую причину.

Лицензия

Apache License 2.0 — подробности см. в LICENSE.

Создано Daniel Hodgetts • 𝕏 @daehonz1