Ableton MCP 확장

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

개선된 포크(Fork)입니다. Remote Script 22개 명령과 MCP 도구 25개가 추가되었습니다: MIDI 노트 읽기, 씬(scene), session 클립 속성, 믹서(mute/solo/arm, 센드), Wavetable 모듈레이션 매트릭스, undo/redo. 자세한 내용과 설치 방법은 FORK-NOTES.md를 참조하세요.

영상 데모: 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 환경에 대한 포괄적이고 프로그래밍적인 제어를 제공합니다.

• 세션 및 트랜스포트 제어:

  • 재생 시작 및 중지.

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

  • 씬 관리: 생성, 삭제, 이름 변경, 실행(fire).

• 트랙 관리:

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

  • 트랙 속성 제어: 볼륨, 팬, 뮤트, 솔로, 암(arm).

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

• MIDI 클립 및 노트 조작:

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

  • 클립 내 노트 추가, 삭제, 트랜스포즈, 퀀타이즈.

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

  • 클립 루프 파라미터 및 팔로우 액션 조정.

• 디바이스 및 파라미터 제어:

  • URI로 Ableton 브라우저에서 악기 및 이펙트 로드.

  • 트랙의 모든 디바이스에 대한 전체 파라미터 목록 가져오기.

  • 정규화된 값(0.0 ~ 1.0)을 사용하여 디바이스 파라미터 설정 및 일괄 설정.

• 오토메이션 및 엔벨로프:

  • 클립 내 모든 디바이스 파라미터에 대한 오토메이션 포인트 추가 및 삭제. [이 기능은 아직 완벽하게 작동하지 않습니다.]

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

• 브라우저 통합:

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

  • 브라우저 경로 또는 URI에서 악기, 이펙트, 샘플 직접 로드.

  • 오디오 파일을 오디오 트랙 또는 클립 슬롯에 직접 가져오기.

• 음성 및 오디오 생성

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

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

  • 사운드 이펙트: AI로 맞춤 SFX 생성.

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

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

  • 예시: XY 마우스 컨트롤러: MCP 프레임워크로 맞춤 Ableton 컨트롤러를 만드는 방법을 보여줍니다.

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

  • 무한한 가능성: Ableton Live용 맞춤 도구와 컨트롤러를 직접 구축하세요.

Related MCP server: io.github.peterkolbe/ableton-for-ai

빠른 시작 (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 사용자 라이브러리 Remote Scripts 폴더를 찾으세요:

   • Windows: C:\Users\[You]\Documents\Ableton\User Library\Remote Scripts\

   • Mac: ~/Music/Ableton/User Library/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의 경우: Settings → 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 Remote Script(init.py)가 소켓 연결을 통해 JSON 명령을 수신합니다.

5. Remote Script가 공식 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 플러그인 지원 - 타사 플러그인 제어 ["Configure" 파라미터 기능을 통해 달성 가능] → 완료!

• Arrangement View - 전체 타임라인 제어

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

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

라이선스 및 크레딧

이 프로젝트는 MIT 라이선스 하에 제공됩니다 - 자세한 내용은 LICENSE를 참조하세요.

다음을 사용하여 제작되었습니다:

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

• ElevenLabs API - 전문 음성 생성

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

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

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

이 프로젝트가 여러분의 창의성에 도움이 된다면 ⭐ 스타를 눌러 주세요!