Ableton MCP Extended

Claude나 Cursor와 같은 AI 어시스턴트를 통해 자연어로 Ableton Live를 제어하세요. 이 프로젝트는 자연어 명령을 Ableton Live 세션 내의 정밀한 작업으로 변환하는 강력한 MCP(Model Context Protocol) 서버를 제공합니다.

비디오 시연: https://www.youtube.com/watch?v=7ZKPIrJuuKk

이 도구는 음악 제작 워크플로우를 간소화하고, 생성형 음악을 실험하며, Ableton Live와의 맞춤형 통합을 구축하려는 프로듀서, 개발자 및 AI 애호가를 위해 설계되었습니다.

이 대화를:

👤 "Create a brief minimalist/neo-classical composition in a style similar to Ólafur Arnalds'. (Ableton MCP) / I've loaded four MIDI tracks called "Noire" and "Noire (2) ["Emotional Felt" presets], "Noire (2) ["Reversed Felt" preset, for ambient background], and "Noire (3) ["Ethereal Felt" preset, also for ambient background]. All loaded with nice piano instruments. You have also a MIDI track called "Strings" with a nice string ensemble instrument loaded. Feel free to add new instruments and effects, if pertinent."
🤖 "Creating MIDI clips... Adding effects... Done!"
👤 "Then, use ElevenLabs MCP to create a spoken-word audio clip (default voice and settings) with a relevant poem in the style of “Jim Morrison” to accompany the composition."  
🤖 "Generating poem... Transforming it into speech... Importing it into your session... Done!"

이런 음악 제작 세션으로 바꿀 수 있습니다:

https://github.com/user-attachments/assets/d6ef2de5-bdeb-4097-acc0-67d70f7f85b3

주요 기능

이 프로젝트는 Ableton Live 환경에 대한 포괄적이고 프로그래밍 가능한 제어 기능을 제공합니다.

• 세션 및 전송 제어:

  • 재생 시작 및 중지.

  • 템포, 박자표, 트랙 수를 포함한 세션 정보 가져오기.

  • 장면 관리: 생성, 삭제, 이름 변경 및 실행.

• 트랙 관리:

  • MIDI 및 오디오 트랙 생성, 이름 변경 및 상세 정보 가져오기.

  • 트랙 속성 제어: 볼륨, 패닝, 음소거, 솔로 및 암(Arm).

  • 트랙 그룹화 및 접기 상태 관리.

• MIDI 클립 및 노트 조작:

  • 지정된 길이로 MIDI 클립 생성 및 이름 지정.

  • 클립 내 노트 추가, 삭제, 조옮김 및 퀀타이즈.

  • 단일 작업으로 여러 노트에 대한 일괄 편집 수행.

  • 클립 루프 매개변수 및 팔로우 액션 조정.

• 장치 및 매개변수 제어:

  • URI를 통해 Ableton 브라우저에서 악기 및 효과 로드.

  • 트랙에 있는 모든 장치의 매개변수 전체 목록 가져오기.

  • 정규화된 값(0.0 ~ 1.0)을 사용하여 장치 매개변수 설정 및 일괄 설정.

• 자동화 및 엔벨로프:

  • 클립 내 모든 장치 매개변수에 대한 자동화 포인트 추가 및 지우기. [이 기능은 아직 완벽하게 작동하지 않습니다.]

  • 기존 클립 엔벨로프에 대한 정보 가져오기.

• 브라우저 통합:

  • Ableton 브라우저 탐색 및 항목 나열.

  • 브라우저 경로 또는 URI에서 직접 악기, 효과 및 샘플 로드.

  • 오디오 파일을 오디오 트랙이나 클립 슬롯으로 직접 가져오기.

• 음성 및 오디오 생성

  • 텍스트 음성 변환(TTS) 통합: ElevenLabs MCP [포함]를 통해 내레이션, 보컬 샘플 또는 음성 요소 생성.

  • 맞춤형 음성 생성: 트랙의 독특한 캐릭터를 위해 음성 복제.

  • 음향 효과: AI로 맞춤형 SFX 생성.

  • 직접 가져오기: 생성된 오디오가 Ableton 세션에 즉시 나타남.

• 맞춤형 도구를 위한 확장 가능한 프레임워크

  • 예시: XY 마우스 컨트롤러: MCP 프레임워크로 맞춤형 Ableton 컨트롤러를 만드는 방법 시연.

  • 초저지연: 고성능 UDP 프로토콜로 반응형 실시간 제어 가능.

  • 무한한 가능성: Ableton Live를 위한 나만의 맞춤형 도구 및 컨트롤러 구축.

빠른 시작 (5분)

사전 요구 사항

• Ableton Live 11+ (모든 에디션)

• Python 3.10 이상

• Claude Desktop 또는 Cursor IDE

1. 코드 가져오기

git clone https://github.com/uisato/ableton-mcp-extended.git
cd ableton-mcp-extended
pip install -e .

2. Ableton 스크립트 설치

1. Ableton 원격 스크립트 폴더 찾기:

   • Windows: C:\Users\[사용자]\Documents\Ableton\User Library\Remote Scripts\

   • Mac: ~/Library/Preferences/Ableton/Live [버전]/User Remote Scripts/

2. 폴더 생성: AbletonMCP

3. AbletonMCP_Remote_Script/__init__.py를 이 폴더에 복사

3. Ableton 구성

1. Ableton Live 열기

2. 환경 설정(Preferences) → Link, Tempo & MIDI로 이동

3. Control Surface를 "AbletonMCP"로 설정

4. Input/Output을 "None"으로 설정

4. AI 어시스턴트 연결

Claude Desktop의 경우:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["C:/path/to/ableton-mcp-extended/MCP_Server/server.py"]
    }
  }
}

Cursor의 경우: 설정 → MCP에서 동일한 경로로 MCP 서버 추가.

5. 창작 시작!

AI 어시스턴트를 열고 다음을 시도해보세요:

• "피아노가 포함된 새 MIDI 트랙 생성해줘"

• "간단한 드럼 비트 추가해줘"

• "현재 어떤 트랙들이 있지?"

작동 원리

graph TB
    A[You: Natural Language] --> B[AI Assistant]
    B --> C[MCP Server]
    C --> D[Ableton Remote Script]
    D --> E[Ableton Live API]
    E --> F[🎵 Your Music]
    
    G[ElevenLabs AI] --> H[Generated Audio]
    H --> C

1. AI 어시스턴트에게 평이한 영어로 명령을 내립니다 (예: "새 MIDI 트랙을 만들고 'Bass'라고 이름 지어줘").

2. AI 어시스턴트가 의도를 파악하고 MCP 서버에서 적절한 도구를 호출합니다.

3. MCP 서버(server.py)가 도구 호출을 수신하고 특정 JSON 명령을 구성합니다.

4. Live 내에서 실행 중인 Ableton 원격 스크립트(init.py)가 소켓 연결을 통해 JSON 명령을 수신합니다.

5. 원격 스크립트가 공식 Ableton Live API를 사용하여 명령을 실행하고 세션에 즉시 변경 사항을 적용합니다.

고급 기능

초저지연 실시간 매개변수 제어를 위해:

# Install the hybrid server
cp -r Ableton-MCP_hybrid-server/AbletonMCP_UDP/ ~/Remote\ Scripts/AbletonMCP_UDP/

# Try the XY Mouse Controller example
cd experimental_tools/xy_mouse_controller
python mouse_parameter_controller_udp.py

이것은 다음을 구축하는 방법을 보여줍니다:

• Ableton을 위한 맞춤형 실시간 컨트롤러

• 표현력이 풍부한 연주 도구

• 인터랙티브 음악 애플리케이션

이 저장소는 ElevenLabs용 서버와 같은 다른 MCP 서버와 통합되어 오디오를 생성하고 프로젝트로 직접 가져올 수 있습니다.

지침에 따라 ElevenLabs MCP 서버를 설정하세요.

AI 어시스턴트의 구성을 업데이트하여 두 서버를 모두 포함하세요.

예시 mcp-config.json:

{
  "mcpServers": {
    "AbletonMCP": {
      "command": "python",
      "args": ["/path/to/ableton-mcp-extended/server.py"]
    },
    "ElevenLabs": {
      "command": "python",
      "args": ["/path/to/elevenlabs_mcp/server.py"],
      "env": {
        "ELEVENLABS_API_KEY": "your-api-key-here"
      }
    }
  }
}

구성 요소 개요

이 프로젝트에는 몇 가지 특수 구성 요소가 포함되어 있습니다:

핵심 MCP 서버

• 안정적인 AI 제어를 위한 표준 TCP 통신

• 광범위한 Ableton Live API 통합

• Claude Desktop, Cursor 및 Gemini CLI와 호환

하이브리드 TCP/UDP 서버

• 고성능 실시간 매개변수 제어

• 라이브 공연을 위한 초저지연

• 컨트롤러 및 인터랙티브 도구에 적합

ElevenLabs 통합

• 전문적인 텍스트 음성 변환 생성

• 맞춤형 음성 생성 및 복제

• Ableton 세션으로 직접 가져오기

• 실시간 SFX 생성

실험적 도구 및 예시

• XY 마우스 컨트롤러: 맞춤형 Ableton 컨트롤러를 만드는 방법을 보여주는 예시

• 확장 가능한 프레임워크: 나만의 제어 인터페이스를 만들기 위한 기반

• 개념 증명: MCP 접근 방식의 강력함과 유연성 입증

문서

• 설치 가이드 - 상세 설정 지침

• 사용자 가이드 - 무엇을, 어떤 것을, 어떻게

커뮤니티 및 지원

• GitHub Issues: 버그 보고 및 기능 요청

• Discussions: 창작물을 공유하고 도움 받기

창작물 공유

AI로 생성한 실험작을 태그해주세요! 커뮤니티가 무엇을 만드는지 보는 것을 좋아합니다:

YouTube | Instagram | Patreon | Website

다음 단계

• 자동화 포인트 배치 버그 수정

• ~~VST 플러그인 지원 - 타사 플러그인 제어 ["구성" 매개변수 기능을 통해 달성 가능함]~~ → 완료!

• 어레인지먼트 뷰 - 전체 타임라인 제어

• 하드웨어 통합 - AI를 통한 MIDI 컨트롤러 브리지

• 고급 AI - 더 똑똑하고 나은 음악 이해 및 생성

라이선스 및 크레딧

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE를 참조하세요.

제작 도구:

• Model Context Protocol - AI 통합 프레임워크

• ElevenLabs API - 전문 음성 생성

• Ableton Live - 디지털 오디오 워크스테이션

영감: 원본 ableton-mcp 프로젝트

음악 제작 커뮤니티를 위해 ❤️로 제작되었습니다

이 프로젝트가 창의성에 도움이 된다면 ⭐ 별표를 고려해주세요!