MCP 服务器

Robot Framework MCP Server

A Model Context Protocol server that enables generating and managing Robot Framework test automation with SeleniumLibrary, including test case generation, page object models, and advanced web testing capabilities.

Tools

start_browser

Generate Robot Framework code to start a browser with specified options. Returns .robot file content as text - does not execute.

navigate_to_url

Generate Robot Framework code to navigate to a URL with optional element waiting. Returns .robot file content as text - does not execute.

interact_with_element

Generate Robot Framework code to interact with web elements. Returns .robot file content as text - does not execute.

create_advanced_selenium_keywords

Generate Robot Framework keywords for advanced Selenium operations. Returns .robot file content as text - does not execute.

create_login_test_case

Generate Robot Framework test case code for login functionality. Returns the complete .robot file content as text - does not execute the test.

create_page_object_login

Generate Robot Framework page object model code for login page. Returns .robot file content as text - does not execute.

create_extended_selenium_keywords

Generate extended Robot Framework keywords for screenshots, performance monitoring, and window management. Returns .robot file content as text - does not execute.

create_performance_monitoring_test

Generate Robot Framework performance monitoring test code. Returns complete .robot file content as text - does not execute.

create_data_driven_test

Generate Robot Framework data-driven test template code. Returns .robot file content as text - does not execute.

create_api_integration_test

Generate Robot Framework API integration test code. Returns .robot file content as text - does not execute.

validate_robot_framework_syntax

Validate Robot Framework syntax and provide suggestions. Returns validation report as text - does not execute code.

README

Robot Framework MCP Server

A Model Context Protocol (MCP) server for Robot Framework test automation

Features

🤖 Generate Robot Framework test cases with SeleniumLibrary
📄 Create page object models for web testing
⚡ Advanced Selenium keywords for common web interactions
📸 Screenshot capabilities and performance monitoring
🎯 Input validation and configurable selectors
📊 Performance monitoring and metrics collection
🔄 Data-driven testing templates
🌐 API integration testing capabilities

Prerequisites

Python 3.10 or higher
Node.js 14.0 or higher (for npx method)
UV (for UV method - optional but recommended)
Git (for installation from repository)

Installation & Usage

Method 1: Using npx (Node.js Package Manager)

Add to your MCP client configuration (e.g., mcp.json or Claude Desktop settings):

{
  "servers": {
    "robotframework-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "git+https://github.com/sourcefuse/robotframework-MCP.git"
      ],
      "type": "stdio"
    }
  }
}

Method 2: Using UV (Recommended - Faster & More Reliable)

First install UV:

# Install UV (choose one method)
curl -LsSf https://astral.sh/uv/install.sh | sh  # Unix/macOS
# OR
pip install uv  # Any platform
# OR on Windows PowerShell (as Administrator)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Then add to your MCP configuration:

{
  "servers": {
    "robotframework-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "git+https://github.com/sourcefuse/robotframework-MCP.git",
        "python",
        "-c",
        "import mcp_server; mcp_server.main()"
      ],
      "type": "stdio"
    }
  }
}

Available Tools

The MCP server provides the following comprehensive tools for Robot Framework test automation:

🔧 Core Test Generation

create_login_test_case(url, username, password, template_type="appLocator") - Generate validated login test with configurable selectors
create_page_object_login(template_type="appLocator") - Generate login page object model with validation
create_data_driven_test(test_data_file="test_data.csv") - Generate data-driven test templates
create_api_integration_test(base_url, endpoint, method="GET") - Generate API + UI integration tests

⚡ Advanced Keywords

create_advanced_selenium_keywords() - Generate advanced SeleniumLibrary keywords (dropdowns, checkboxes, file uploads, alerts, etc.)
create_extended_selenium_keywords() - Generate extended keywords with screenshots, performance monitoring, and window management