MCP Adobe Premiere Pro

Instructions

Implementation Reference

• src/tools/index.ts:1234-1280 (handler)

  The primary handler function for the 'remove_effect' tool. It constructs an ExtendScript that finds the clip by ID, iterates through its effects to find the matching effect name, removes it, and returns success/error status via the PremiereProBridge.

  private async removeEffect(clipId: string, effectName: string): Promise<any> {
    const script = `
      try {
        var clip = app.project.getClipByID("${clipId}");
        if (!clip) {
          JSON.stringify({
            success: false,
            error: "Clip not found"
          });
          return;
        }
        
        var effects = clip.getEffects();
        var removed = false;
        
        for (var i = 0; i < effects.length; i++) {
          if (effects[i].displayName === "${effectName}") {
            clip.removeEffect(effects[i]);
            removed = true;
            break;
          }
        }
        
        if (!removed) {
          JSON.stringify({
            success: false,
            error: "Effect not found on clip"
          });
          return;
        }
        
        JSON.stringify({
          success: true,
          message: "Effect removed successfully",
          clipId: "${clipId}",
          effectName: "${effectName}"
        });
      } catch (e) {
        JSON.stringify({
          success: false,
          error: e.toString()
        });
      }
    `;
    
    return await this.bridge.executeScript(script);
  }

• src/tools/index.ts:200-207 (registration)

  The 'remove_effect' tool is registered in the getAvailableTools() method, defining its name, description, and Zod input schema for validation.

  {
    name: 'remove_effect',
    description: 'Removes an effect from a clip.',
    inputSchema: z.object({
      clipId: z.string().describe('The ID of the clip'),
      effectName: z.string().describe('The name of the effect to remove')
    })
  },

• src/tools/index.ts:477-478 (registration)

  In the executeTool method's switch statement, the 'remove_effect' case dispatches to the removeEffect handler with parsed arguments.

    return await this.removeEffect(args.clipId, args.effectName);
  case 'add_transition':

• src/tools/index.ts:203-206 (schema)

  Zod schema definition for 'remove_effect' tool inputs: clipId (string) and effectName (string).

  inputSchema: z.object({
    clipId: z.string().describe('The ID of the clip'),
    effectName: z.string().describe('The name of the effect to remove')
  })