Ableton Copilot MCP

에이블톤-코파일럿-MCP

Ableton Live와의 실시간 상호작용 및 제어를 위해 Ableton-js 기반으로 구축된 MCP(Model Context Protocol) 서버로, 음악 프로듀서의 음악 제작을 지원하는 데 전념합니다.

🎯 참고

음악 프로듀서로서 저는 Ableton을 활용한 음악 제작에 대해 어느 정도 이해하고 있습니다. 창작 과정에서는 음표 속성 휴머니즘화, 음표 병합, 한 트랙을 다른 오디오 트랙에 녹음하는 등 다양하고 지루한 작업을 처리해야 하는 경우가 많습니다. 이전에는 이러한 작업을 호스트 DAW에서 제공하는 기능에만 의존할 수 있었습니다. 그러나 대규모 언어 모델과 MCP(Manual Computing Program)의 등장으로 이제 AI가 자동화를 지원할 수 있게 되었습니다. AI가 직접 음표를 생성하거나 완전한 곡을 만드는 것은 아직 현실적이지 않지만(좋은 사운드의 곡을 만들 수는 없으니까요), AI가 보조 작업을 지원함으로써 새로운 가능성을 제시합니다.

🚀 특징

🎵 노래 제어

• 기본적인 노래 정보(근음, 음계 이름, 템포, 노래 길이 등)를 얻으세요.
• 모든 트랙 목록 가져오기
• MIDI, 오디오 및 리턴 트랙 생성
• 트랙 삭제 및 복제

🎹 트랙 관리

• 트랙의 모든 클립 가져오기
• 편곡 보기 트랙에 빈 MIDI 클립을 만듭니다.
• 제공된 샘플 파일 경로를 기반으로 트랙에 오디오 클립을 만듭니다.
• 트랙 속성(음소거, 색상, 이름, 암, 솔로 등)을 설정합니다.
• 지정된 트랙에 MIDI 클립 복제

🎼 클립 작업

• 피아노 롤 보기에서 클립 가져오기
• 클립의 모든 노트를 가져와 관리하세요
• 클립에 노트 추가, 삭제 및 교체
• 클립 속성(이름, 색상, 루핑, 루프 시작, 루프 종료 등)을 설정합니다.

🎧 오디오 작업

• 시간 범위에 따라 트랙 콘텐츠 녹음 지원

🔌 기기 관리

• 오디오 효과, 악기 및 플러그인 로드
• 장치 매개변수 수정
• 라이브러리에서 사용 가능한 장치를 찾아보세요

📝 상태 관리

• 작업 내역 추적 및 상세 로깅
• 중요 작업을 위한 스냅샷 생성
• 작업 롤백 지원(특히 노트 작업)
• 이전 상태를 탐색하고 복원합니다.

📝 할 일 목록

• MIDI 클립을 생성할 때 생성된 clip_id를 반환하도록 허용(Ableton-js 업데이트 보류)
• 자동 봉투 조정 지원
• 더 많은 스냅샷 유형(트랙 속성, 장치 매개변수 등)을 지원합니다.

⚠️ 경고

• AI가 MIDI 클립을 직접 조작하면 원본 음표가 손실될 수 있으며 Ctrl + Z로 되돌릴 수 없습니다. 주의해서 조작하십시오. 필요한 경우 AI에게 음표 작업을 롤백하도록 요청할 수 있습니다.

📥 설치

필수 조건

• Node.js 환경: Node.js가 설치되어 있는지 확인하세요(v20 이상 권장) 및 npx 명령을 사용할 수 있는지 확인하세요.

  🔗 다운로드: Node.js 공식 웹사이트

설치 단계

1. AbletonJS MIDI 원격 스크립트 설치

MIDI 원격 스크립트를 설치하려면 다음 세 가지 방법 중 하나를 선택하세요.

• 방법 1: 한 줄 설치(권장)지엑스피1
• 방법 2: 도구 지원 설치
  1. 먼저, ableton-copilot-mcp를 시작합니다(아래 사용 섹션 참조).
  2. AI 어시스턴트를 사용하거나 수동으로 MCP 도구 init_ableton_js 호출하여 설치를 자동으로 완료합니다.
• 방법 3: 수동 설치
  1. Ableton 사용자 라이브러리에 "Remote Scripts"라는 이름의 폴더를 만듭니다.
     • Windows: C:\Users\[username]\Documents\Ableton\User Library\Remote Scripts
     • Mac: /Users/[username]/Music/Ableton/User Library\Remote Scripts
  2. ableton-js 프로젝트에서 MIDI 원격 스크립트를 다운로드하세요
  3. 다운로드한 midi-script 폴더를 위 위치에 복사하세요.
  4. AbletonJS 로 이름을 바꾸세요

🔧 사용법

빠른 시작

1. Ableton Live 실행
2. AbletonJS 컨트롤 표면 활성화
   • Ableton Live 환경 설정 열기: Preferences → Link/MIDI
   • MIDI 탭에서 Control Surface 섹션을 찾으세요.
   • 드롭다운 메뉴에서 AbletonJS 선택하세요
3. MCP 클라이언트를 사용하여 연결다음 클라이언트를 MCP 엔드포인트로 사용할 수 있습니다.
   • 커서
   • 체리 스튜디오
   • 클로드 데스크탑
   • 다른 MCP 클라이언트

클라이언트 구성

커서 구성 예

커서 설정에 다음 구성을 추가하세요.

최신 버전을 보려면:

사용자 정의 저장 경로(선택 사항)

BASE_PATH 환경 변수를 사용하여 사용자 정의 데이터 저장 위치를 지정할 수 있습니다.

💡 팁 : 저장 경로는 로그 파일, 작업 내역 및 상태 스냅샷을 저장하는 데 사용됩니다.

사용 팁

• 처음 연결할 때 Ableton Live와 통신을 설정하는 데 몇 초가 걸릴 수 있습니다.
• Ableton Live가 실행 중이고 AbletonJS Control Surface가 제대로 로드되었는지 확인하세요.
• 연결 상태를 확인하려면 MCP 도구에서 get_song_status 명령을 사용할 수 있습니다.

✅ 호환성 테스트

호환성은 주로 Ableton-js 라이브러리의 버전 지원에 따라 달라집니다.

🤝 기여하기

이슈와 기여를 환영합니다. GitHub Issues를 통해 이슈나 제안을 제출해 주세요.

📄 라이센스

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

⚠️ 면책 조항

이것은 타사 통합이며 Ableton에서 만든 것이 아닙니다.