Robot Framework MCP Server

Instructions

Implementation Reference

• mcp_server.py:703-944 (handler)

  The handler function decorated with @mcp.tool() that implements the tool by generating and returning a comprehensive Robot Framework test suite for website performance monitoring, including metrics collection, threshold validation, interaction tests, and reporting.
  @mcp.tool() def create_performance_monitoring_test() -> str: """Generate Robot Framework performance monitoring test code. Returns complete .robot file content as text - does not execute.""" return """*** Settings *** Library SeleniumLibrary Library Collections Library DateTime Library OperatingSystem *** Variables *** ${PERFORMANCE_THRESHOLD_LOAD} 3000 # 3 seconds ${PERFORMANCE_THRESHOLD_INTERACTIVE} 2000 # 2 seconds ${PERFORMANCE_THRESHOLD_PAINT} 1000 # 1 second *** Test Cases *** Website Performance Test [Documentation] Comprehensive website performance testing [Tags] performance load-time metrics # Start performance monitoring ${test_start}= Get Current Date result_format=epoch Open Browser ${TEST_URL} chrome options=add_argument("--enable-precise-memory-info") # Wait for page to fully load Wait Until Page Does Not Contain Loading timeout=30s Sleep 2s # Allow all resources to load # Collect performance metrics ${metrics}= Collect Performance Metrics # Validate performance thresholds Validate Performance Thresholds ${metrics} # Test page interactions performance Test Page Interaction Performance # Generate performance report Generate Performance Report ${metrics} Close Browser *** Keywords *** Collect Performance Metrics [Documentation] Collect comprehensive performance metrics # Navigation timing metrics ${navigation_timing}= Execute Javascript ... var timing = window.performance.timing; ... return { ... 'dns_lookup': timing.domainLookupEnd - timing.domainLookupStart, ... 'tcp_connect': timing.connectEnd - timing.connectStart, ... 'request_response': timing.responseEnd - timing.requestStart, ... 'dom_processing': timing.domComplete - timing.domLoading, ... 'load_complete': timing.loadEventEnd - timing.navigationStart, ... 'dom_ready': timing.domContentLoadedEventEnd - timing.navigationStart, ... 'first_paint': timing.responseStart - timing.navigationStart ... }; # Paint timing metrics (if supported) ${paint_timing}= Execute Javascript ... if ('getEntriesByType' in window.performance) { ... var paints = window.performance.getEntriesByType('paint'); ... var result = {}; ... paints.forEach(function(paint) { ... result[paint.name.replace('-', '_')] = paint.startTime; ... }); ... return result; ... } ... return {}; # Memory usage (if supported) ${memory_info}= Execute Javascript ... if ('memory' in window.performance) { ... return { ... 'used_js_heap': window.performance.memory.usedJSHeapSize, ... 'total_js_heap': window.performance.memory.totalJSHeapSize, ... 'heap_limit': window.performance.memory.jsHeapSizeLimit ... }; ... } ... return {}; # Resource timing ${resource_count}= Execute Javascript ... if ('getEntriesByType' in window.performance) { ... var resources = window.performance.getEntriesByType('resource'); ... var types = {}; ... resources.forEach(function(resource) { ... var type = resource.initiatorType || 'other'; ... types[type] = (types[type] || 0) + 1; ... }); ... types['total'] = resources.length; ... return types; ... } ... return {}; # Combine all metrics ${all_metrics}= Create Dictionary Set To Dictionary ${all_metrics} navigation=${navigation_timing} Set To Dictionary ${all_metrics} paint=${paint_timing} Set To Dictionary ${all_metrics} memory=${memory_info} Set To Dictionary ${all_metrics} resources=${resource_count} [Return] ${all_metrics} Validate Performance Thresholds [Documentation] Validate performance against thresholds [Arguments] ${metrics} ${navigation}= Get From Dictionary ${metrics} navigation # Check load time ${load_time}= Get From Dictionary ${navigation} load_complete Should Be True ${load_time} < ${PERFORMANCE_THRESHOLD_LOAD} ... Page load time (${load_time}ms) exceeds threshold (${PERFORMANCE_THRESHOLD_LOAD}ms) # Check DOM ready time ${dom_ready}= Get From Dictionary ${navigation} dom_ready Should Be True ${dom_ready} < ${PERFORMANCE_THRESHOLD_INTERACTIVE} ... DOM ready time (${dom_ready}ms) exceeds threshold (${PERFORMANCE_THRESHOLD_INTERACTIVE}ms) # Check first paint time (if available) ${paint}= Get From Dictionary ${metrics} paint ${has_first_paint}= Run Keyword And Return Status Dictionary Should Contain Key ${paint} first_paint IF ${has_first_paint} ${first_paint}= Get From Dictionary ${paint} first_paint Should Be True ${first_paint} < ${PERFORMANCE_THRESHOLD_PAINT} ... First paint time (${first_paint}ms) exceeds threshold (${PERFORMANCE_THRESHOLD_PAINT}ms) END Test Page Interaction Performance [Documentation] Test performance of page interactions # Test scroll performance ${scroll_start}= Get Time epoch Execute Javascript window.scrollTo(0, document.body.scrollHeight); Sleep 0.5s Execute Javascript window.scrollTo(0, 0); ${scroll_end}= Get Time epoch ${scroll_time}= Evaluate (${scroll_end} - ${scroll_start}) * 1000 Log Scroll performance: ${scroll_time}ms Should Be True ${scroll_time} < 500 Scroll should be smooth (< 500ms) # Test click response time (if interactive elements exist) ${buttons}= Get WebElements css=button, input[type="submit"], .btn ${button_count}= Get Length ${buttons} IF ${button_count} > 0 ${button}= Get From List ${buttons} 0 ${click_start}= Get Time epoch Click Element ${button} Sleep 0.1s # Small delay to register interaction ${click_end}= Get Time epoch ${click_time}= Evaluate (${click_end} - ${click_start}) * 1000 Log Click response time: ${click_time}ms Should Be True ${click_time} < 200 Click response should be immediate (< 200ms) END Generate Performance Report [Documentation] Generate detailed performance report [Arguments] ${metrics} ${timestamp}= Get Current Date result_format=%Y-%m-%d_%H-%M-%S ${report_file}= Set Variable performance_report_${timestamp}.txt ${navigation}= Get From Dictionary ${metrics} navigation ${resources}= Get From Dictionary ${metrics} resources ${report_content}= Catenate SEPARATOR=\n ... PERFORMANCE TEST REPORT ... ========================= ... Test URL: ${TEST_URL} ... Test Time: ${timestamp} ... ... NAVIGATION TIMING: ... - DNS Lookup: ${navigation}[dns_lookup]ms ... - TCP Connect: ${navigation}[tcp_connect]ms ... - Request/Response: ${navigation}[request_response]ms ... - DOM Processing: ${navigation}[dom_processing]ms ... - Page Load Complete: ${navigation}[load_complete]ms ... - DOM Ready: ${navigation}[dom_ready]ms ... ... RESOURCE LOADING: ... - Total Resources: ${resources}[total] if 'total' in ${resources} else 'N/A' ... ... PERFORMANCE THRESHOLDS: ... - Load Time Threshold: ${PERFORMANCE_THRESHOLD_LOAD}ms ... - Interactive Threshold: ${PERFORMANCE_THRESHOLD_INTERACTIVE}ms ... - Paint Threshold: ${PERFORMANCE_THRESHOLD_PAINT}ms Create File ${report_file} ${report_content} Log Performance report saved to: ${report_file} Performance Comparison Test [Documentation] Compare performance across multiple test runs [Arguments] ${test_iterations}=3 @{all_results}= Create List FOR ${iteration} IN RANGE 1 ${test_iterations + 1} Log Running performance test iteration ${iteration} Open Browser ${TEST_URL} chrome Sleep 2s ${metrics}= Collect Performance Metrics Append To List ${all_results} ${metrics} Close Browser Sleep 5s # Wait between tests END # Calculate average performance ${avg_metrics}= Calculate Average Performance ${all_results} Log Average performance across ${test_iterations} runs: ${avg_metrics} Calculate Average Performance [Documentation] Calculate average performance from multiple test runs [Arguments] ${results_list} ${total_load}= Set Variable 0 ${total_dom}= Set Variable 0 ${count}= Get Length ${results_list} FOR ${result} IN @{results_list} ${navigation}= Get From Dictionary ${result} navigation ${load_time}= Get From Dictionary ${navigation} load_complete ${dom_time}= Get From Dictionary ${navigation} dom_ready ${total_load}= Evaluate ${total_load} + ${load_time} ${total_dom}= Evaluate ${total_dom} + ${dom_time} END ${avg_load}= Evaluate ${total_load} / ${count} ${avg_dom}= Evaluate ${total_dom} / ${count} ${averages}= Create Dictionary avg_load_time=${avg_load} avg_dom_ready=${avg_dom} [Return] ${averages} """
• mcp_server.py:703-703 (registration)

  The @mcp.tool() decorator registers the create_performance_monitoring_test function as an MCP tool.
  @mcp.tool()