Robot Framework MCP Server

Instructions

Implementation Reference

• mcp_server.py:234-407 (handler)

  The core handler function for the 'create_advanced_selenium_keywords' tool. Decorated with @mcp.tool(), it returns a multi-line template string containing advanced Robot Framework SeleniumLibrary keywords for operations like dropdowns, checkboxes, file uploads, alerts, mouse actions, scrolling, window management, JavaScript execution, waits, tables, and form validation.

  def create_advanced_selenium_keywords() -> str:
      """Generate Robot Framework keywords for advanced Selenium operations. Returns .robot file content as text - does not execute."""
      template = """*** Settings ***
  Library    SeleniumLibrary
  
  *** Keywords ***
  # Dropdown/Select Operations
  Select Dropdown Option By Label
      [Arguments]    ${locator}    ${label}
      [Documentation]    Select option from dropdown by visible text
      Wait Until Element Is Visible    ${locator}    10s
      Select From List By Label    ${locator}    ${label}
  
  Select Dropdown Option By Value
      [Arguments]    ${locator}    ${value}
      [Documentation]    Select option from dropdown by value
      Wait Until Element Is Visible    ${locator}    10s
      Select From List By Value    ${locator}    ${value}
  
  # Checkbox Operations
  Select Checkbox If Not Selected
      [Arguments]    ${locator}
      [Documentation]    Select checkbox only if it's not already selected
      Wait Until Element Is Visible    ${locator}    10s
      ${is_selected}=    Run Keyword And Return Status    Checkbox Should Be Selected    ${locator}
      Run Keyword If    not ${is_selected}    Select Checkbox    ${locator}
  
  Unselect Checkbox If Selected
      [Arguments]    ${locator}
      [Documentation]    Unselect checkbox only if it's currently selected
      Wait Until Element Is Visible    ${locator}    10s
      ${is_selected}=    Run Keyword And Return Status    Checkbox Should Be Selected    ${locator}
      Run Keyword If    ${is_selected}    Unselect Checkbox    ${locator}
  
  # File Upload Operations
  Upload File To Element
      [Arguments]    ${locator}    ${file_path}
      [Documentation]    Upload file using file input element
      Wait Until Element Is Visible    ${locator}    10s
      Choose File    ${locator}    ${file_path}
  
  # Alert/Pop-up Operations
  Handle Alert And Accept
      [Documentation]    Handle JavaScript alert and accept it
      Alert Should Be Present
      Accept Alert
  
  Handle Alert And Dismiss
      [Documentation]    Handle JavaScript alert and dismiss it
      Alert Should Be Present
      Dismiss Alert
  
  Get Alert Text And Accept
      [Documentation]    Get alert text and accept the alert
      Alert Should Be Present
      ${alert_text}=    Get Alert Message
      Accept Alert
      RETURN    ${alert_text}
  
  # Mouse Operations
  Hover Over Element
      [Arguments]    ${locator}
      [Documentation]    Hover mouse over an element
      Wait Until Element Is Visible    ${locator}    10s
      Mouse Over    ${locator}
  
  Double Click On Element
      [Arguments]    ${locator}
      [Documentation]    Double click on an element
      Wait Until Element Is Visible    ${locator}    10s
      Double Click Element    ${locator}
  
  Right Click On Element
      [Arguments]    ${locator}
      [Documentation]    Right click on an element
      Wait Until Element Is Visible    ${locator}    10s
      Open Context Menu    ${locator}
  
  # Scroll Operations
  Scroll To Element
      [Arguments]    ${locator}
      [Documentation]    Scroll element into view
      Wait Until Element Is Visible    ${locator}    10s
      Scroll Element Into View    ${locator}
  
  Scroll To Bottom Of Page
      [Documentation]    Scroll to the bottom of the page
      Execute JavaScript    window.scrollTo(0, document.body.scrollHeight)
  
  Scroll To Top Of Page
      [Documentation]    Scroll to the top of the page
      Execute JavaScript    window.scrollTo(0, 0)
  
  # Window/Tab Operations
  Switch To New Window
      [Documentation]    Switch to the newly opened window/tab
      ${current_windows}=    Get Window Handles
      ${window_count}=    Get Length    ${current_windows}
      Should Be True    ${window_count} > 1    New window should be opened
      Switch Window    ${current_windows}[-1]
  
  Close Current Window And Switch Back
      [Documentation]    Close current window and switch to previous one
      Close Window
      Switch Window    MAIN
  
  # JavaScript Operations
  Execute Custom JavaScript
      [Arguments]    ${javascript_code}
      [Documentation]    Execute custom JavaScript code
      ${result}=    Execute JavaScript    ${javascript_code}
      RETURN    ${result}
  
  Set Element Attribute
      [Arguments]    ${locator}    ${attribute}    ${value}
      [Documentation]    Set attribute value of an element using JavaScript
      Wait Until Element Is Visible    ${locator}    10s
      Execute JavaScript    arguments[0].setAttribute('${attribute}', '${value}');    ARGUMENTS    ${locator}
  
  Get Element Attribute Value
      [Arguments]    ${locator}    ${attribute}
      [Documentation]    Get attribute value of an element
      Wait Until Element Is Visible    ${locator}    10s
      ${value}=    Get Element Attribute    ${locator}    ${attribute}
      RETURN    ${value}
  
  # Advanced Wait Operations
  Wait Until Element Contains Text
      [Arguments]    ${locator}    ${expected_text}    ${timeout}=10s
      [Documentation]    Wait until element contains specific text
      Wait Until Element Is Visible    ${locator}    ${timeout}
      Wait Until Element Contains    ${locator}    ${expected_text}    ${timeout}
  
  Wait Until Page Title Contains
      [Arguments]    ${expected_title}    ${timeout}=10s
      [Documentation]    Wait until page title contains expected text
      Wait Until Title Contains    ${expected_title}    ${timeout}
  
  Wait For Element To Disappear
      [Arguments]    ${locator}    ${timeout}=10s
      [Documentation]    Wait for element to disappear from page
      Wait Until Element Is Not Visible    ${locator}    ${timeout}
  
  # Table Operations
  Get Table Cell Text
      [Arguments]    ${table_locator}    ${row}    ${column}
      [Documentation]    Get text from specific table cell
      ${cell_text}=    Get Table Cell    ${table_locator}    ${row}    ${column}
      RETURN    ${cell_text}
  
  Get Table Row Count
      [Arguments]    ${table_locator}
      [Documentation]    Get number of rows in table
      ${row_count}=    Get Element Count    ${table_locator}//tr
      RETURN    ${row_count}
  
  # Form Validation
  Verify Field Is Required
      [Arguments]    ${locator}
      [Documentation]    Verify field has required attribute
      ${is_required}=    Get Element Attribute    ${locator}    required
      Should Not Be Empty    ${is_required}    Field should be required
  
  Verify Field Is Disabled
      [Arguments]    ${locator}
      [Documentation]    Verify field is disabled
      Element Should Be Disabled    ${locator}
  
  Verify Field Is Enabled
      [Arguments]    ${locator}
      [Documentation]    Verify field is enabled
      Element Should Be Enabled    ${locator}
  """
      return template

• mcp_server.py:233-233 (registration)

  The @mcp.tool() decorator registers this function as an MCP tool named 'create_advanced_selenium_keywords'.

  @mcp.tool()