Robot Framework

You can run and use the Robot Framework MCP Server to generate test artifacts, page objects, and advanced test flows for Robot Framework with SeleniumLibrary. It provides templates, validation, and API integration testing capabilities to streamline automated web testing workflows.

How to use

Start by choosing how you want to run the MCP server from your MCP client. You can run it locally via npx, Python, UV, or by cloning the repository for development. Once the server is reachable, you use the MCP client to load the server configuration and execute the provided tools to generate test cases, page objects, and data-driven templates. When you request a generated artifact, you can customize selectors, templates, and data sources, and the server will return ready-to-use Robot Framework snippets and supporting assets.

How to install

Prerequisites you need before installing and running the MCP server include a supported runtime and a MCP client workflow.

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

How to install

Install the MCP server via PyPI to run it directly with a simple command.

# Install the package
pip3 install robotframework-mcp

# Run the MCP server
robotframework-mcp

How to install

Configure MCP client snippets to connect to the locally running server. The following example shows a standard stdio-based client configuration.

{
  "mcpServers": {
    "robotframework-mcp": {
      "command": "robotframework-mcp",
      "type": "stdio"
    }
  }
}

How to install

If you prefer using UV for running the MCP server, install UV and configure the client accordingly.

{
  "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"
    }
  }
}

How to install

If you want to run the MCP server from a cloned repository, follow the development/setup steps and then run the server directly.

# Clone the repository
git clone https://github.com/sourcefuse/robotframework-MCP.git
cd robotframework-MCP

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run the MCP server directly
python mcp_server.py

How to install

If you are configuring an MCP client to connect to a locally run server via a Node.js wrapper, you can point the client to the wrapper script in the cloned repository.

{
  "servers": {
    "robotframework-mcp": {
      "command": "node",
      "args": [
        "/path/to/cloned/robotframework-MCP/bin/robotframework-mcp.js",
        "--project-dir=/path/to/your/project"
      ],
      "type": "stdio"
    }
  }
}

How to install

If you prefer starting the server via Python by directly invoking the module, you can use a Python command from the cloned repo.

{
  "servers": {
    "robotframework-mcp": {
      "command": "python",
      "args": ["/path/to/cloned/robotframework-MCP/mcp_server.py"],
      "type": "stdio"
    }
  }
}

Additional notes

The MCP server offers a range of tools to generate and validate Robot Framework test artifacts. It supports multiple selector templates for web applications and includes input validation to ensure URLs, credentials, and selectors are well-formed. You can combine core test generation with advanced Selenium keywords, data-driven templates, and API integration tests to build comprehensive test suites.

Troubleshooting and tips

• Ensure your runtime (Python 3.10+ or Node.js 14+) is installed before starting the MCP server. - If you encounter issues starting from a local clone, verify that the virtual environment is active and dependencies are installed. - Use the data-driven and API integration templates to accelerate test coverage for web applications.

Available tools

create_login_test_case

Generate a validated login test with configurable selectors

create_page_object_login

Generate a login page object model with validation

create_data_driven_test

Generate data-driven test templates

create_api_integration_test

Generate API + UI integration tests

create_advanced_selenium_keywords

Generate advanced SeleniumLibrary keywords for dropdowns, checkboxes, file uploads, alerts, etc.

create_extended_selenium_keywords

Generate extended keywords with screenshots, performance monitoring, and window management

create_performance_monitoring_test

Generate comprehensive performance testing with metrics collection

validate_robot_framework_syntax

Validate Robot Framework syntax and provide improvement suggestions