ClaudeのようなAIアシスタントがPTSL(Pro Tools Scripting Library) gRPC APIを介してPro Toolsを制御することを可能にするMCP(Model Context Protocol)サーバー。

⚠️ 実験プロジェクト: これは進行中の作業であり、まだすべてのPro Toolsの機能が実装されていない。 自分の責任で使用してください!

##特徴

サーバは、AI アシスタントに以下の機能を提供します。

• セッション管理 - クエリセッション情報、セッションの保存、包括的なセッション概要の取得
• タイムラインナビゲーション - 地図とクリップをページネーションでブラウズし、名前で検索し、タイムラインをナビゲート(オーディオクリップのみ)
• トラックコントロール - リスト、選択、ミュート、ソロ、およびトラックの管理
• クリップ管理 - タイムライン上のオーディオクリップを見つけて作業
• Editing Operations - 切口、コピー、ペースト、クリア、タイムラインの選択と取消し
• マーカー - セッションマーカーの作成、リスト、およびナビゲーション -トランスポートコントロール - 再生、停止、記録、および再生 -仮想分析 - 波形画像を生成し、オーディオコンテンツを分析(onsets、ピーク、沈黙検出) -Raw PTSL Access - 高度なユースケースにカスタムPTSLコマンドを送信
• 診断 - 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)