Reaper MCP Server

Сервер связывает проекты Reaper с любым MCP-клиентом (например, Claude Desktop) и позволяет задавать вопросы о содержимом проекта на естественном языке.

Возможности

Сервер предоставляет два инструмента, работающих в паре:

• find_reaper_projects — находит все проекты Reaper в заданной директории.
• parse_reaper_project — превращает выбранный проект Reaper в JSON для анализа.

При обращении к ассистенту (Claude) достаточно назвать конкретный проект — сервер сам найдёт файл, распарсит его и вернёт ответ.

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

Установка

Предварительные требования

• Установленный uv
• Python 3.11+

Шаги

1. Клонируйте репозиторий и перейдите в папку сервера.

2. Создайте виртуальное окружение и установите зависимости:

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

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

1. Откройте папку setup/ и найдите файл claude_desktop_config.json — это образец конфигурации.

2. Скопируйте его в конфигурацию Claude Desktop (следуйте официальной инструкции MCP для подключения кастомного сервера).

3. В файле конфигурации укажите три обязательных пути:

   • Путь к исполняемому файлу uv
   • Путь к директории с вашими проектами Reaper
   • Путь к папке с данным сервером

Пример конфигурации:

{
  "mcpServers": {
    "reaper": {
      "command": "/путь/к/uv",
      "args": ["--directory", "/путь/к/серверу", "run", "mcp-server"],
      "env": {
        "REAPER_PROJECTS_DIR": "/путь/к/проектам"
      }
    }
  }
}

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

1. Откройте Claude Desktop.
2. В правом нижнем углу поля ввода найдите иконку молотка 🔨.
3. Нажмите на неё — должны отобразиться два доступных инструмента: find_reaper_projects и parse_reaper_project.
4. Задайте вопрос, обязательно указав имя проекта (например, «Расскажи про треки в проекте MySong.RPP»).

Примечания

• Название проекта обязательно — без него сервер не сможет найти нужный файл.
• В окне инструментов Claude можно развернуть блоки и увидеть «сырой» JSON, который сервер передаёт ассистенту.
• Всё взаимодействие происходит локально, данные не покидают ваш компьютер.

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

• src/ — исходный код сервера
• setup/ — пример конфигурационного файла для Claude Desktop
• pyproject.toml — зависимости и метаданные пакета