프로젝트 소개

Logic Pro MCP Server는 Claude Code, Claude Desktop, Cursor, VS Code 및 사용자 정의 에이전트와 같은 MCP 클라이언트가 AI 지원 음악 제작을 위해 Logic Pro를 구동할 수 있게 해주는 로컬 Model Context Protocol 서버입니다. Logic Pro는 에이전트 기반 작곡이나 세션 제어를 위한 자사 API를 제공하지 않기 때문에, 이 프로젝트는 일곱 가지 네이티브 macOS 제어 채널(MCU, Accessibility, AppleScript, CoreMIDI, CGEvent, Scripter, MIDI Key Commands)을 하나의 MCP 인터페이스 뒤에 결합합니다. 에이전트가 할 수 있는 일: - 트랜스포트: 재생, 정지, 녹음, 위치 이동, 사이클, 메트로놈, 템포를 실시간 상태 읽기와 함께 수행합니다. - 트랙: 생성, 삭제, 복제, 선택, 이름 변경, 음소거, 솔로, 암, 악기 설정. - MIDI 작곡: 서버 측에서 SMF를 생성하고, MIDI를 가져오고, 노트/CC/MMC를 전송하고, 가상 포트를 생성합니다. - 믹서: 볼륨, 팬, 플러그인 스냅샷, 보호된 기본 제공 플러그인 삽입. - 라이브러리: Logic의 악기 라이브러리를 스캔하고 경로별로 패치를 로드합니다. - 내비게이션: 마디, 마커, 줌, 보기 토글. - 프로젝트 수명 주기: 새로 만들기, 열기, 저장, 다른 이름으로 저장, 닫기, 바운스, 내보내기 계획, 종료. 런타임 표면은 10개의 도구, 18개의 정적 리소스, 12개의 리소스 템플릿으로 설명됩니다. 도구는 작업을 수행하고, 리소스는 상태(트랜스포트, 트랙, 믹서, 프로젝트 정보, 감사, 정리 계획, MIDI 포트 등)를 노출하므로 클라이언트는 폴링 대신 읽을 수 있습니다. 핵심 설계 포인트는 결과에 대한 정직성입니다. 변경 작업은 확인됨, 불확실함 또는 실패 상태를 반환하고, 파괴적 작업 및 플러그인 삽입 흐름은 명시적 확인을 요구하며, 불확실한 대상은 쓰기 전에 fail closed됩니다. 플러그인 적용-반영은 프로젝트 ID, 대상 트랙, 삽입 슬롯, 플러그인 ID 및 읽기 값이 모두 일치한 후에만 검증됨으로 보고됩니다. 읽기 표면은 출처와 최신성 레이블을 포함합니다. 설치는 SHA256이 고정된 Homebrew tap을 통해 또는 Swift로 소스에서 빌드하여 수행됩니다. 고정된 셸 설치 프로그램은 fail-closed이며 명시적 해시 및 팀 ID 핀이 없으면 실행을 거부합니다. 설정에는 MCU 컨트롤 서피스 등록과 선택적으로 번들된 Scripter 삽입이 필요합니다. `doctor` 명령은 기능 준비 상태, 차단된 검사, 인과적 수정 계획 및 이유와 함께 건너뛴 검사를 보고합니다. 요구 사항은 서버와 Logic Pro에 대해 macOS 14+이며, 최신 Logic 릴리스가 일급 검증 대상으로 취급됩니다. 이 패키지는 의도적으로 작은 공개 표면을 가진 라이브러리 제품 LogicProMCPKit도 노출합니다.