Premiere Pro MCP Server

Instructions

Implementation Reference

• mcp-server.js:432-477 (handler)

  Executes the tool logic by fetching sequence details from localhost:3001/api/sequence-details, processing video/audio tracks, effects, and markers, and returning a formatted text response.

  async getSequenceDetails(sequenceName) {
    try {
      const response = await fetch(`http://localhost:3001/api/sequence-details?name=${encodeURIComponent(sequenceName)}`);
      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}`,
            },
          ],
        };
      }
  
      const videoTracks = data.tracks.video_tracks.map(track => 
        `  • Track ${track.track_number}: ${track.track_name} (${track.clip_count} clips) ${track.is_locked ? '🔒' : ''} ${track.is_visible ? '👁️' : '🙈'}`
      ).join('\n');
  
      const audioTracks = data.tracks.audio_tracks.map(track => 
        `  • Track ${track.track_number}: ${track.track_name} (${track.clip_count} clips) ${track.is_locked ? '🔒' : ''} ${track.is_muted ? '🔇' : '🔊'} ${track.is_solo ? '🎯' : ''}`
      ).join('\n');
  
      return {
        content: [
          {
            type: 'text',
            text: `🎬 **Sequence Details: ${data.sequence_name}**\n\n**Settings:**\n• Resolution: ${data.settings.resolution.width}x${data.settings.resolution.height}\n• Frame Rate: ${data.settings.frame_rate} fps\n• Audio: ${data.settings.audio_sample_rate} Hz\n\n**Video Tracks:**\n${videoTracks}\n\n**Audio Tracks:**\n${audioTracks}\n\n**Applied Effects:** ${data.effects_applied.join(', ')}\n**Markers:** ${data.markers.length}`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `❌ **Failed to get sequence details**\n\nError: ${error.message}`,
          },
        ],
        isError: true,
      };
    }
  }

• mcp-server.js:60-73 (schema)

  Defines the tool schema with input requiring 'sequence_name' string.

  {
    name: "get_sequence_details",
    description: "Get detailed information about a specific sequence including tracks, effects, and markers",
    inputSchema: {
      type: "object",
      properties: {
        sequence_name: {
          type: "string",
          description: "Name of the sequence to get details for"
        }
      },
      required: ["sequence_name"]
    }
  },

• mcp-server.js:231-233 (registration)

  Registers the handler dispatch in the CallToolRequest switch statement.

  case 'get_sequence_details':
    return await this.getSequenceDetails(args.sequence_name);

• mcp-server.js:31-214 (registration)

  Registers the tool in the ListToolsRequestHandler by including it in the tools array.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => {
    const tools = [
      {
        name: "get_project_info",
        description: "Get basic information about the current Premiere Pro project",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_active_sequence_info", 
        description: "Get detailed information about the currently active sequence",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "list_all_sequences",
        description: "List all sequences in the current project with basic info",
        inputSchema: {
          type: "object", 
          properties: {},
          required: []
        }
      },
      {
        name: "get_sequence_details",
        description: "Get detailed information about a specific sequence including tracks, effects, and markers",
        inputSchema: {
          type: "object",
          properties: {
            sequence_name: {
              type: "string",
              description: "Name of the sequence to get details for"
            }
          },
          required: ["sequence_name"]
        }
      },
      {
        name: "get_timeline_structure",
        description: "Get the track structure of the active sequence",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_timeline_clips", 
        description: "Get all clips in the active sequence with detailed information",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_project_media",
        description: "Get all media items in the project browser with file information",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_project_bins",
        description: "Get project bin structure and organization",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_playhead_info",
        description: "Get current playhead position and playback state",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_selection_info",
        description: "Get information about currently selected clips or time range",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_export_presets",
        description: "Get available export presets and their settings",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "get_render_queue",
        description: "Get current render queue status and items",
        inputSchema: {
          type: "object",
          properties: {},
          required: []
        }
      },
      {
        name: "trim_clip_by_frames",
        description: "Trim or extend the in/out point of a video or audio clip by a number of frames.",
        inputSchema: {
          type: "object",
          properties: {
            sequenceId: { type: "number", description: "Index of the sequence (0-based)" },
            clipId: { type: "string", description: "ID of the clip to trim" },
            framesDelta: { type: "number", description: "Number of frames to trim (positive or negative)" },
            direction: { type: "string", enum: ["in", "out"], description: "Which edit point to trim ('in' or 'out')" },
            trackType: { type: "string", enum: ["video", "audio"], description: "Track type ('video' or 'audio')" }
          },
          required: ["sequenceId", "clipId", "framesDelta", "direction", "trackType"]
        }
      },
      {
        name: 'create_sequence',
        description: 'Create a new sequence in Premiere Pro',
        inputSchema: {
          type: 'object',
          properties: {
            name: {
              type: 'string',
              description: 'Name of the new sequence',
            },
            width: {
              type: 'number',
              description: 'Width in pixels (default: 1920)',
            },
            height: {
              type: 'number', 
              description: 'Height in pixels (default: 1080)',
            },
            framerate: {
              type: 'number',
              description: 'Frame rate (default: 23.976)',
            },
          },
          required: ['name'],
        },
      },
      {
        name: 'export_project',
        description: 'Export the current project or sequence',
        inputSchema: {
          type: 'object',
          properties: {
            output_path: {
              type: 'string',
              description: 'Output file path',
            },
            preset_name: {
              type: 'string',
              description: 'Export preset name (default: H.264 High Quality)',
            },
            include_audio: {
              type: 'boolean',
              description: 'Include audio in export (default: true)',
            },
          },
          required: ['output_path'],
        },
      },
    ];
  
    return {
      tools,
    };
  });