PlayMCP Browser Automation Server

Instructions

Implementation Reference

• src/controllers/playwright.ts:439-463 (handler)

  The main handler function getForms() in PlaywrightController class that uses page.evaluate to extract all forms, their action/method, and input fields from the current page.

  async getForms(): Promise<Array<{action?: string, method?: string, fields: Array<{name?: string, type?: string, value?: string}>}>> {
    try {
      if (!this.isInitialized()) {
        throw new Error('Browser not initialized');
      }
      this.log('Getting page forms');
      const forms = await this.state.page?.evaluate(() => {
        const formElements = Array.from(document.querySelectorAll('form'));
        return formElements.map(form => ({
          action: form.getAttribute('action') || undefined,
          method: form.getAttribute('method') || undefined,
          fields: Array.from(form.querySelectorAll('input, select, textarea')).map(field => ({
            name: field.getAttribute('name') || undefined,
            type: field.getAttribute('type') || field.tagName.toLowerCase(),
            value: (field as HTMLInputElement).value || undefined
          }))
        }));
      });
      this.log('Forms retrieved:', forms?.length);
      return forms || [];
    } catch (error: any) {
      console.error('Get forms error:', error);
      throw new BrowserError('Failed to get forms', 'Check if the page is loaded');
    }
  }

• src/server.ts:173-181 (schema)

  The Tool schema definition for 'getForms', specifying no input parameters.

  const GET_FORMS_TOOL: Tool = {
    name: "getForms",
    description: "Get all forms from the current page",
    inputSchema: {
      type: "object",
      properties: {},
      required: []
    }
  };

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

  Registration of the getForms tool in the tools dictionary passed to MCP server capabilities.

  getForms: GET_FORMS_TOOL,

• src/server.ts:740-745 (registration)

  Dispatch handler in callTool request handler that invokes the getForms method and returns the JSON stringified result.

  case 'getForms': {
    const forms = await playwrightController.getForms();
    return {
      content: [{ type: "text", text: JSON.stringify(forms, null, 2) }]
    };
  }