Premiere Pro MCP Server

Instructions

Implementation Reference

• mcp-server.js:350-387 (handler)

  The main handler function implementing the 'get_active_sequence_info' tool. It fetches active sequence information from a local HTTP API endpoint and returns a formatted text response with details like name, duration, frame rate, resolution, tracks, etc. Includes comprehensive error handling.
  async getActiveSequenceInfo() { try { const response = await fetch('http://localhost:3001/api/active-sequence'); if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`); const data = await response.json(); if (data.error) { return { content: [ { type: 'text', text: `⚠️ ${data.error}\n\n🔧 **Troubleshooting Steps:**\n1. Make sure Premiere Pro is running\n2. Open a project with an active sequence\n3. Ensure the CEP extension is loaded\n4. Click "Refresh Project Info" in the extension`, }, ], }; } return { content: [ { type: 'text', text: `🎬 **Active Sequence Details**\n\n**Name:** ${data.sequence_name}\n**Duration:** ${data.duration}\n**Frame Rate:** ${data.frame_rate} fps\n**Resolution:** ${data.resolution.width}x${data.resolution.height}\n**Audio Sample Rate:** ${data.audio_sample_rate} Hz\n**Timecode Start:** ${data.timecode_start}\n**Playhead Position:** ${data.playhead_position}\n**Video Tracks:** ${data.track_count.video_tracks}\n**Audio Tracks:** ${data.track_count.audio_tracks}`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `❌ **Failed to get active sequence info**\n\nError: ${error.message}\n\n🔧 **Troubleshooting:**\n1. Check that the HTTP server is running on port 3001\n2. Ensure Premiere Pro is open with an active sequence\n3. Verify CEP extension is loaded and functional`, }, ], isError: true, }; } }
• mcp-server.js:42-50 (schema)

  The tool schema definition returned by ListToolsRequestSchema, specifying the tool name, description, and empty input schema (no parameters required).
  { name: "get_active_sequence_info", description: "Get detailed information about the currently active sequence", inputSchema: { type: "object", properties: {}, required: [] } },
• mcp-server.js:225-226 (registration)

  Tool registration/dispatch in the CallToolRequestSchema switch statement, routing calls to the getActiveSequenceInfo handler method.
  case 'get_active_sequence_info': return await this.getActiveSequenceInfo();