PlayMCP Browser Automation Server

Instructions

Implementation Reference

• src/controllers/playwright.ts:801-814 (handler)

  The core handler function that executes the file upload logic using Playwright's locator.setInputFiles method.

  async uploadFiles(selector: string, filePaths: string[]): Promise<void> {
    try {
      if (!this.isInitialized() || !this.state.page) {
        throw new Error('Browser not initialized');
      }
      this.log('Uploading files', { selector, filePaths });
      const locator = this.state.page.locator(selector);
      await locator.setInputFiles(filePaths);
      this.log('File upload complete');
    } catch (error: any) {
      console.error('File upload error:', error);
      throw new BrowserError('Failed to upload files', 'Check if selector is a file input and files exist');
    }
  }

• src/server.ts:411-426 (schema)

  Defines the Tool object including name, description, and input schema for validation.

  const UPLOAD_FILES_TOOL: Tool = {
    name: "uploadFiles",
    description: "Upload files through a file input element",
    inputSchema: {
      type: "object",
      properties: {
        selector: { type: "string" },
        filePaths: {
          type: "array",
          items: { type: "string" },
          description: "Array of absolute file paths to upload"
        }
      },
      required: ["selector", "filePaths"]
    }
  };

• src/server.ts:546-546 (registration)

  Registers the uploadFiles tool in the MCP server's tools capabilities map.

  uploadFiles: UPLOAD_FILES_TOOL,

• src/server.ts:913-924 (handler)

  MCP server request handler case that validates inputs and delegates to the Playwright controller for execution.

  case 'uploadFiles': {
    if (!args.selector || !args.filePaths) {
      return {
        content: [{ type: "text", text: "Selector and file paths are required" }],
        isError: true
      };
    }
    await playwrightController.uploadFiles(args.selector as string, args.filePaths as string[]);
    return {
      content: [{ type: "text", text: "Files uploaded successfully" }]
    };
  }