Automation Script Generator MCP Server

Instructions

Implementation Reference

• index.js:238-267 (registration)

  Tool registration configuration including name, description, and input schema validation for generate_page_file

  {
      name: 'generate_page_file',
      description: 'Generate WDIO page object file with general functions and element selectors',
      inputSchema: {
          type: 'object',
          properties: {
              scenario_title: {
                  type: 'string',
                  description: 'Title of the test scenario',
                  minLength: 1,
              },
              selectors: {
                  type: 'object',
                  description: 'Selectors for each UI element',
              },
              page_functions: {
                  type: 'array',
                  items: { type: 'string' },
                  description: 'List of page functions needed',
              },
              output_path: {
                  type: 'string',
                  description: 'Path where the page file should be saved',
                  minLength: 1,
              },
          },
          required: ['scenario_title', 'selectors', 'output_path'],
          additionalProperties: false,
      },
  },

• index.js:1023-1043 (handler)

  Main handler function for the generate_page_file tool: destructures args, calls buildPageFileContent to generate code, ensures directory exists, writes file to output_path, returns confirmation with generated content

  async generatePageFile(args) {
      const { scenario_title, selectors, page_functions = [], output_path } = args;
  
      try {
          const pageContent = this.buildPageFileContent(scenario_title, selectors, page_functions);
  
          await fs.ensureDir(path.dirname(output_path));
          await fs.writeFile(output_path, pageContent);
  
          return {
              content: [
                  {
                      type: 'text',
                      text: `Page file generated successfully at: ${output_path}\n\nContent:\n${pageContent}`,
                  },
              ],
          };
      } catch (error) {
          throw new Error(`Failed to generate page file: ${error.message}`);
      }
  }

• index.js:1123-1143 (helper)

  Helper function that generates the complete page object JavaScript code: creates class name, generates selector getter methods and page action methods, formats as string with JSDoc

      buildPageFileContent(scenario_title, selectors, page_functions) {
          const className = this.toPascalCase(scenario_title.replace(/[^a-zA-Z0-9]/g, '')) + 'Page';
          const selectorMethods = this.generateSelectorMethods(selectors);
          const pageMethods = this.generatePageMethods(page_functions);
  
          return `/**
   * Page Object Model for ${scenario_title}
   * Contains selectors and page-specific functions
   */
  
  class ${className} {
    // Element selectors
  ${selectorMethods}
  
    // Page functions
  ${pageMethods}
  }
  
  module.exports = ${className};
  `;
      }

• index.js:1739-1744 (helper)

  Helper that generates getter methods for page selectors from selectors object

        return Object.keys(selectors).map(key => {
            return `  get ${this.toCamelCase(key)}() {
    return $('${selectors[key]}');
  }`;
        }).join('\n\n');
    }

• index.js:1746-1753 (helper)

  Helper that generates async page action methods from list of page_functions

      generatePageMethods(page_functions) {
          return page_functions.map(func => {
              const methodName = this.toCamelCase(func);
              return `  async ${methodName}() {
  ${this.generatePageMethodImplementation(func, methodName)}
    }`;
          }).join('\n\n');
      }