REAPER MCP 서버
AI 에이전트가 MIDI 및 오디오 기능을 모두 갖춘 REAPER에서 완벽하게 믹싱 및 마스터링된 트랙을 생성할 수 있도록 하는 포괄적인 MCP(Model Context Protocol) 서버입니다.
특징
- 프로젝트 관리 완료(생성, 저장, 렌더링)
- 작업 추적(생성, 라우팅, 매개변수 조정)
- MIDI 작곡 및 편집
- 오디오 녹음 및 가져오기
- 가상 악기 및 효과 관리
- 믹싱 및 자동화
- 도구 마스터링
- 오디오 분석 및 피드백
요구 사항
- REAPER DAW 설치됨
- 파이썬 3.8 이상
- REAPER에서 OSC 지원이 활성화됨(OSC 모드용)
- REAPER에서 ReaScript API 활성화(ReaScript 모드용)
설치
지엑스피1
용법
빠른 시작
시작하는 가장 쉬운 방법은 제공된 시작 스크립트를 사용하는 것입니다.
# Start REAPER first
open /Applications/REAPER.app # On macOS
# or start REAPER manually on other platforms
# Then start the MCP server
./scripts/start_reaper_mcp_server.sh # On Unix/Mac
윈도우 사용자
Windows 사용자의 경우 제공된 Windows 스크립트 중 하나를 사용하세요.
# Using Command Prompt (CMD)
scripts\start_reaper_mcp_server.bat
# Using PowerShell
powershell -ExecutionPolicy Bypass -File scripts\start_reaper_mcp_server.ps1
구성
기본적으로 서버는 OSC 모드를 사용하는데, 이 모드는 더욱 안정적이며 ReaScript API가 제대로 작동할 필요가 없습니다. 명령줄 인수를 사용하여 서버를 구성할 수 있습니다.
# Start in OSC mode (default)
./scripts/start_reaper_mcp_server.sh --mode=osc # Unix/Mac
scripts\start_reaper_mcp_server.bat --mode=osc # Windows CMD
powershell -File scripts\start_reaper_mcp_server.ps1 -mode osc # Windows PowerShell
# Start in ReaScript mode
./scripts/start_reaper_mcp_server.sh --mode=reapy # Unix/Mac
scripts\start_reaper_mcp_server.bat --mode=reapy # Windows CMD
powershell -File scripts\start_reaper_mcp_server.ps1 -mode reapy # Windows PowerShell
# Configure OSC settings (Unix/Mac)
./scripts/start_reaper_mcp_server.sh --host=192.168.1.110 --send-port=8000 --receive-port=9000
# Configure OSC settings (Windows CMD)
scripts\start_reaper_mcp_server.bat --host=192.168.1.110 --send-port=8000 --receive-port=9000
# Configure OSC settings (Windows PowerShell)
powershell -File scripts\start_reaper_mcp_server.ps1 -host "192.168.1.110" -sendPort 8000 -receivePort 9000
# Enable debug logging
./scripts/start_reaper_mcp_server.sh --debug # Unix/Mac
scripts\start_reaper_mcp_server.bat --debug # Windows CMD
powershell -File scripts\start_reaper_mcp_server.ps1 -debug # Windows PowerShell
OSC를 위한 REAPER 설정
- REAPER를 엽니다
- 환경 설정 > 제어/OSC/웹으로 이동하세요
- "추가"를 클릭하고 "OSC(오픈 사운드 컨트롤)"를 선택하세요.
- 다음 설정을 구성하세요.
- 장치 이름: ReaperMCP
- 모드: 로컬 포트
- 로컬 수신 포트: 8000
- 로컬 IP: 127.0.0.1(또는 컴퓨터의 IP 주소)
- REAPER 작업 및 FX 학습에 바인딩 메시지 허용: 선택됨(선택 사항)
- 발신 최대 패킷 크기: 1024
- 패킷 간 대기 시간: 10ms
ReaScript를 위한 REAPER 설정
- REAPER를 엽니다
- 환경 설정 > 플러그인 > ReaScript로 이동하세요.
- "ReaScript에 Python 사용"이 체크되어 있는지 확인하세요.
- Python DLL/dylib 경로를 Python 설치 경로로 설정하세요.
- macOS에서:
/opt/homebrew/Cellar/python@3.x/3.xx/Frameworks/Python.framework/Versions/3.x/Python - Windows의 경우:
C:\Path\to\Python\python3x.dll
- 설치 스크립트를 실행합니다.
python scripts/setup_reaper_python.py
프로젝트 구조
src/reaper_mcp/ : 메인 패키지 디렉토리__main__.py : 명령줄 인터페이스osc_server.py : OSC 기반 서버 구현server.py : ReaScript 기반 서버 구현
examples/ : 사용법을 보여주는 예제 스크립트scripts/ : 설정 및 실행을 위한 유틸리티 스크립트
MCP 도구
서버는 다음과 같은 MCP 도구를 제공합니다.
create_project : 새로운 REAPER 프로젝트를 생성합니다create_track : 현재 프로젝트에 새 트랙을 만듭니다.list_tracks : 현재 프로젝트의 모든 트랙을 나열합니다.add_midi_note : 트랙에 MIDI 노트를 추가합니다.get_project_info : 현재 프로젝트에 대한 정보를 가져옵니다.
문제 해결
ReaScript API 문제
ReaScript API에 문제가 발생하는 경우 대신 OSC 모드를 사용해 보세요.
./scripts/start_reaper_mcp_server.sh --mode=osc
OSC 커뮤니케이션 문제
REAPER가 OSC에 대해 올바르게 구성되었는지 확인하세요.
- REAPER의 OSC 설정이 서버 설정과 일치하는지 확인하세요.
- 방화벽이 통신을 차단하지 않는지 확인하세요.
- 네트워크 IP 대신 로컬 IP 주소(127.0.0.1)를 사용해 보세요.
Windows 관련 문제 해결
Windows에서 MCP 서버를 실행하는 데 문제가 있는 경우:
- 스크립트 실행 문제 :
- PowerShell 스크립트의 경우 실행 정책을 조정해야 할 수 있습니다.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser - 또는 예제에 표시된 대로
-ExecutionPolicy Bypass 플래그를 사용하세요.
- 경로 문제 :
- 스크립트의 REAPER 경로가 설치 위치와 일치하는지 확인하세요.
- 기본값은
C:\Program Files\REAPER\reaper.exe 이며 필요한 경우 수정하세요.
- 가상 환경 :
- 다른 방법으로 venv를 생성한 경우 활성화 스크립트가 다른 위치에 있을 수 있습니다.
- 실행하기 전에 수동으로 활성화해보세요:
venv\Scripts\activate
- 방화벽 차단 :
- Windows 방화벽이 OSC 통신을 차단할 수 있습니다.
- Windows 방화벽 설정에 Python 및 REAPER에 대한 예외 추가
- 관리자 권한 :
- 권한 문제가 발생하면 명령 프롬프트 또는 PowerShell을 관리자 권한으로 실행해 보세요.
특허
MIT