MCP (모델 Context Protocol) 서버는 PTSL (Pro Tools Scripting Library) gRPC API를 통해 Pro Tools를 제어하기 위해 Claude와 같은 AI 조수를 가능하게 합니다.

⚠️ ** 실험 프로젝트 : ** 이것은 진행중인 작업이며 모든 Pro Tools 기능이 아직 구현되지 않았습니다. 당신의 위험에 사용!

특징

서버는 다음과 같은 기능을 가진 AI 조수를 제공합니다:

• Session Management - Query 세션 정보, 세션 저장, 포괄적인 세션 개요 -Timeline Navigation - 질과 클립, 이름을 검색, 타임라인 탐색 (audio clips only)
• Track Control - List, select, mute, solo, 관리 트랙 -Clip Management - 타임라인에서 오디오 클립을 찾아 작업
• Editing Operations - 컷, 복사, 페이스트, 클리어, undo/redo 와 타임라인 선택 -Markers - 만들기, 목록 및 탐색 세션 마커
• Transport Control - 재생, 중지, 기록 및 제어 재생 -Visual Analysis - 파형 이미지 생성 및 오디오 컨텐츠 분석(onsets, peak, silence detection)
• **Raw PTSL Access ** - 고급 사용 사례에 대한 사용자 정의 PTSL 명령을 보내십시오.
• Diagnostics - PTSL 연결 상태를 테스트 및 검증

Pro Tools MCP Server

An MCP (Model Context Protocol) server that enables AI assistants like Claude to control Pro Tools via the PTSL (Pro Tools Scripting Library) gRPC API.

⚠️ Experimental Project: This is a work in progress and not all Pro Tools features are implemented yet. Use at your own risk!

Features

The server provides AI assistants with the following capabilities:

• Session Management - Query session info, save sessions, get comprehensive session overview
• Timeline Navigation - Browse tracks and clips with pagination, search by name, navigate the timeline (audio clips only)
• Track Control - List, select, mute, solo, and manage tracks
• Clip Management - Find and work with audio clips on the timeline
• Editing Operations - Cut, copy, paste, clear, undo/redo with timeline selections
• Markers - Create, list, and navigate session markers
• Transport Control - Play, stop, record, and control playback
• Visual Analysis - Generate waveform images and analyze audio content (onsets, peaks, silence detection)
• Raw PTSL Access - Send custom PTSL commands for advanced use cases
• Diagnostics - Test and verify PTSL connection status

Known Limitations

• MIDI Clips: The timeline indexing only captures audio clips. MIDI clip positions cannot be queried due to PTSL API limitations. MIDI clips can be seen in the clip list but their timeline positions are not available.

Safety Features

The server uses a granular permission system to protect your Pro Tools sessions. By default, it runs in read-only mode with safe audio analysis enabled.

Default Permissions (No Configuration Needed)

Always allowed:

• Read operations (queries, track lists, clip info, session info)
• Playback control (play, stop, toggle)
• UI state changes (mute/solo, timeline selection, edit tools)
• Copy to clipboard (non-destructive)
• Export audio to temp directories only (enables audio analysis)

Blocked by default (require ALLOW_WRITES to enable):

• Creating/editing markers (memory)
• Cut/paste/clear operations (clipboard)
• Exporting to custom paths (export)
• Creating/deleting tracks (track_structure)
• Saving/opening sessions (session)
• Recording (recording)

Enabling Write Operations

Use the ALLOW_WRITES environment variable to enable specific permission groups:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "protools": {
      "command": "node",
      "args": ["/absolute/path/to/protools-mcp-server/dist/index.js"],
      "env": {
        "PTSL_PROTO_PATH": "/absolute/path/to/PTSL.proto",
        "ALLOW_WRITES": "memory,clipboard"
      }
    }
  }
}

Command Line:

# Allow markers and clipboard editing
ALLOW_WRITES=memory,clipboard PTSL_PROTO_PATH=/path/to/PTSL.proto node dist/index.js

# Allow everything (use with caution)