{"type": "text"}

Reaper MCP Server

Это MCP-сервер, который подключает проекты Reaper к MCP-клиенту, такому как Claude Desktop, позволяя вам задавать вопросы о ваших проектах и получать комплексный анализ звука для обратной связи по микшированию.

Этот сервер по своей конструкции доступен только для чтения. Он не предоставляет инструментов, которые позволяют ИИ изменять ваш проект. Он хорош для понимания того, что вы уже сделали, и для обучения тому, как его улучшить. Позвольте ИИ предложить идеи, и вы сможете попробовать покрутить ручки и понять, как это влияет на вашу музыку.

Инструменты

Обнаружение и разбор проектов

• find_reaper_projects: Находит все проекты Reaper в указанной вами в конфигурации директории.

• parse_reaper_project: Разбирает файл проекта Reaper (.RPP) и возвращает подробную информацию, включая темп, дорожки, цепочки FX и аудио-элементы.

  Каждая дорожка несет свою позицию и идентичность (track_number соответствует порядку отображения в Reaper, guid), маршрутизацию (is_folder/folder_depth, main_send, receives, num_channels, midi_hardware_out) и состояние микшера (volume, pan, mute, solo). Каждый элемент несет position, length, start_offset, playrate, mute, фейды и каждый тейк — с пометкой активного тейка, поскольку именно он воспроизводится.

  Записи receives называют исходную дорожку по индексу и по имени, что отличает живой сигнальный путь от оставшейся дорожки: дорожка с main_send: false не достигает мастера, и ее звук слышен только через то, что получает от нее.

Эти инструменты работают в тандеме. Когда вы задаете Клоду вопрос о конкретном проекте Reaper, он использует инструмент find_reaper_projects для поиска проекта, а затем использует инструмент parse_reaper_project для разбора проекта и ответа на ваш вопрос.

Обнаружение установленных FX

• list_installed_fx(plugin_type=None, search_query=None): Перечисляет все установленные FX/плагины, доступные в Reaper.

  Параметры:

  • plugin_type (необязательно): Фильтр по типу плагина (VST2, VST3, AU, JS, CLAP)

  • search_query (необязательно): Поиск плагинов по имени, производителю или типу

  Возвращает: Список установленных плагинов, включая:

  • Название плагина

  • Тип плагина (VST2, VST3, AU, JS, CLAP)

  • Путь к файлу

  • Производитель (если доступен)

  Примеры вопросов:

  • "Какие синтезаторные плагины у меня установлены?"

  • "Покажи все мои плагины Waves"

  • "Я ищу вибрирующий синтезатор. Какие варианты есть из уже установленных плагинов?"

  • "Перечисли все мои плагины VST3"

  • "Есть ли у меня плагины реверберации?"

  • "Какие плагины iZotope у меня есть?"

  • "Покажи все мои плагины Audio Unit"

  Примечание: Этот инструмент сканирует файлы кэша плагинов Reaper. Если вы недавно установили новые плагины и еще не просканировали их в Reaper, они не появятся в результатах. Убедитесь, что вы открыли Reaper и позволили ему сначала просканировать новые плагины.

Анализ звука

• analyze_audio_files(project_path, track_filter=None, whole_file=False): Анализирует звук в проекте Reaper для обратной связи по микшированию.

  Параметры:

  • project_path (обязательно): Путь к файлу проекта .RPP

  • track_filter (необязательно): Фильтр дорожек по имени (например, "Vocal" для анализа только вокальных дорожек)

  • whole_file (необязательно): Анализировать весь исходный файл вместо только той области, которую воспроизводит каждый элемент. По умолчанию выключено.

  Возвращает: Комплексный анализ звука, включая:

  • Анализ уровня: Пиковые уровни, RMS, обнаружение клиппинга, постоянное смещение (DC offset)

  • Частотный анализ: Спектральный центроид и доля каждой полосы в общей энергии

  • Стерео-изображение: Ширина стерео, фазовая когерентность, совместимость с моно

  • Динамический диапазон и громкость: LUFS (стандарты громкости), истинный пик, пик-фактор

  Примеры вопросов:

  • "Проанализируй весь звук в моем проекте Rock Song"

  • "Проверь вокальные дорожки на клиппинг"

  • "Не слишком ли громкий мой микс для стриминговых платформ?"

  • "Есть ли проблемы с фазой в моих барабанных дорожках?"

  Что измеряется: По умолчанию каждый элемент анализируется точно по области, которую он воспроизводит — его смещение начала источника, длина и скорость воспроизведения — а не весь исходный файл. Различные области анализируются один раз и используются повторно, поэтому элемент, повторяющийся в аранжировке, стоит одного измерения. MIDI-элементы не имеют аудиоисточника и перечислены в разделе skipped, а не сообщаются как ошибки.

  Частотные показатели относительны. Каждая полоса сообщается как доля общей спектральной мощности этой области (и та же доля в дБ). Абсолютная энергия полосы масштабируется с длиной клипа, из-за чего длинный файл выглядит на десятки дБ «горячее», чем короткий с идентичным материалом, и делает сравнение между файлами бессмысленным.

  Эти числа до FX. Анализ читает исходные файлы с диска, поэтому он не отражает ни цепочку FX дорожки, ни ее фейдер. На дорожке с эмулятором усилителя или тяжелым эквалайзером анализ описывает сырой DI, а не то, что вы слышите. Каждый ответ помечен как signal_stage: pre-fx.

  Пороговые значения предупреждений:

  • Пик > -0.3 дБFS: Риск клиппинга

  • Обнаружен клиппинг: присутствуют цифровые искажения

  • 200–500 Гц более чем на 10 дБ выше 500–2000 Гц: Глухие низкие середины. Сравнение этих двух полос друг с другом, а не одной полосы со всем спектром, позволяет не помечать басовую партию просто за то, что она басовая.

  • Среднее значение сэмпла > 0.001: Постоянное смещение (DC offset)

  • Фазовая когерентность < 0.5: Проблемы с фазовым подавлением

  • LUFS > -8: Слишком громко для стриминга (цель Spotify: -14 LUFS)

  • Пик-фактор < 6 дБ: Возможно, пережато

  Громкость сообщается как null, а не как заменитель, когда ее невозможно измерить (области короче 400 мс), а области короче 50 мс измеряются, но не предупреждаются.

Чтобы увидеть все структуры данных, извлекаемые из проектов, посмотрите файл src/reaper_mcp_server/reaper_dataclasses.py.

Related MCP server: AbletonMCP

Настройка

1. Установка зависимостей

   uv venv
   source .venv/bin/activate
   
   uv pip install .

2. Настройка Claude Desktop

   • Следуйте инструкциям по настройке Claude Desktop для использования с пользовательским MCP-сервером

   • Найдите пример конфигурации в setup/claude_desktop_config.json

   • Обновите следующие пути в конфигурации:

     • Путь к вашей установке uv

     • Каталог ваших проектов Reaper

     • Каталог этого сервера

3. Запуск и настройка

   • Откройте Claude Desktop

   • Нажмите значок '+' в поле чата

   • Нажмите «Connectors», и вы должны увидеть включенный коннектор 'reaper'

   

4. Задавайте вопросы!

   • Задавайте вопросы о вашем проекте Reaper

   • Всегда указывайте название конкретного проекта Reaper, о котором вы спрашиваете

   • Вы можете развернуть панели инструментов, чтобы увидеть необработанные данные проекта, передаваемые Клоду