ableton-mind은(는) 무엇을 하나요?
Ableton Live를 위한 최고의 MCP 서버 — 완전한 LOM 지원, 내장 장치 지식 베이스, 선언형 음악 레시피를 제공합니다. Claude, Cursor 또는 Codex를 사용하여 자연어로 Live에서 실제 음악을 제작할 수 있습니다.
설치
사전 요구 사항
- Ableton Live 11 Suite 또는 Live 12 Suite (권장)
- Python 3.10+
- MCP 호환 클라이언트 (Claude Desktop, Cursor, Codex 등)
빠른 시작
- 저장소 복제:
git clone https://github.com/Pantani/ableton-mind.git
cd ableton-mind
- 종속성 설치:
pip install -r requirements.txt
-
Ableton Live에서 MCP 브릿지 설정:
mcp_bridge.amxd파일을 Ableton Live의 Max for Live 기기 폴더에 복사- Live 트랙에 MCP 브릿지 기기 로드
-
MCP 클라이언트 구성:
// claude_desktop_config.json 예시
{
"mcpServers": {
"ableton-mind": {
"command": "python",
"args": ["-m", "ableton_mind"]
}
}
}
- MCP 브릿지 시작:
- MCP 브릿지 기기의 '연결' 버튼 클릭
- 연결 표시등이 녹색으로 바뀌어야 함
기능
완전한 LOM 접근
Ableton Live Object Model의 모든 객체에 접근하고 조작합니다:
- 트랙: 생성, 삭제, 이름 변경, 음소거/솔로, 볼륨/팬 제어
- 클립: 오디오 및 MIDI 클립 생성, 편집, 반복/정량화 설정
- 장치: 기기 추가/제거, 파라미터 조정, 프리셋 로드
- 장면: 장면 생성, 발사, 이름 변경
- 뷰: 세션 뷰와 배열 뷰 간 전환
내장 장치 지식 베이스
AI 에이전트에게 Ableton 내장 장치에 대한 자세한 지식을 제공합니다:
- 장치 유형: Wavetable, Operator, Analog, Drum Rack, Sampler 등
- 파라미터 매핑: 각 장치별 제어 가능한 파라미터와 범위
- 라우팅 가이드: 신호 흐름, 사이드체인, 버스 라우팅
- 모범 사례: 장치별 추천 사용 사례와 설정
선언형 음악 레시피
자연어 설명을 실행 가능한 Live 작업으로 변환합니다:
- 장르 템플릿: "테크노 베이스라인 만들기", "루즈한 힙합 드럼 패턴"
- 분위기 설명: "어두운 패드 사운드", "밝은 리드 신스"
- 구조 생성: "4/4박자 16마디 트랙 구축"
- 믹스 제안: "보컬에 사이드체인 압축 적용"
사용 예시
기본 명령
"4/4박자 킥-스네어-하이햇 기본 비트를 만든 후 템포를 128 BPM으로 설정해 줘."
"Operator를 사용하여 따뜻한 베이스라인을 생성하고 트랙을 'Bass'로 이름 변경해."
"필터 컷오프가 서서히 열리는 8마디 빌드업을 만들어 줘."
고급 워크플로우
"4마디 피아노 코드 진행을 8마디 스트링 패드로 변환해 줘."
"드럼 랙에 사이드체인 압축을 적용하여 킥 드럼이 들어올 때 베이스를 펌핑시키도록 해."
"Wavetable에서 새로운 리드 사운드를 디자인한 후, 현 트랙 위에 추가해 줘."
아키텍처
┌─────────────┐ ┌────────────┐ ┌───────────┐
│ MCP 클라이언트 │────▶│ ablemon-mind │────▶│ MCP 브릿지 │
│ (Claude/Cursor)│ │ Python 서버 │ │ (Max for Live)│
└─────────────┘ └────────────┘ └───────────┘
│
▼
┌───────────┐
│ Ableton Live│
│ (LOM) │
└───────────┘
문제 해결
일반적인 문제
| 문제 | 해결 방법 |
|---|---|
| 브릿지가 연결되지 않음 | MCP 브릿지 기기가 트랙에 로드되었고 '연결'이 활성화되었는지 확인 |
| Python 오류 | Python 3.10+가 설치되어 있고 모든 종속성이 설치되었는지 확인 |
| 권한 거부됨 | Live MIDI 포트가 다른 애플리케이션에 의해 점유되지 않았는지 확인 |
로그
서버 로그는 ~/.ableton_mind/logs/에서 확인할 수 있습니다.
디버깅을 위해 자세한 로깅을 활성화하려면 DEBUG=1 환경 변수를 설정하세요.
지원
라이선스
MIT License - 자세한 내용은 LICENSE 파일을 참조하세요.