Selenium

🚀 MCP Selenium WebDriver Usage Instructions

MCP is a protocol for controlling Selenium WebDriver. It enables sending commands to a remote WebDriver instance via TCP communication.

🚀 Quick Start

MCP is a protocol that allows you to control Selenium WebDriver. It enables you to send commands to a remote WebDriver instance through TCP communication.

✨ Features

• Control Selenium WebDriver via TCP communication.
• Send various commands to interact with web pages.

📦 Installation

Download MCP

Download the latest version of MCP from the MCP official website.

Installation Steps

1. Extract the downloaded file.
2. Place mcp-server.jar and the WebDriver executable file (e.g., chromedriver.exe) in the same directory.
3. Run the following command to start the MCP server:

java -jar mcp-server.jar --port=4444

💻 Usage Examples

Basic Usage

import org.openqa.selenium.WebDriver;

public class Example {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.navigate("https://www.example.com");
        
        // Find an element and click it
        WebElement button = driver.findElement(By.cssSelector("#submit-btn"));
        button.click();
        
        // Enter text
        WebElement input = driver.findElement(By.id("search-box"));
        input.sendKeys("Search content");
        
        driver.closeWindow();
    }
}

Advanced Usage

The above example demonstrates basic operations. You can combine different commands according to your specific needs, such as using more complex selectors or performing multiple actions in sequence.

📚 Documentation

Common Commands

Get Element Information

!wd getelementinfo <selector> [attribute]

• Parameters:
  • <selector>: Element selector (e.g., id, css, xpath).
  • [attribute]: Optional, the name of the attribute to get.

Click an Element

!wd click <selector>

Enter Text

!wd type <selector> <text>

Submit a Form

!wd submit <selector>

Get Page Title

!wd gettitle

Check if an Element Exists

!wd elementexists <selector>

Take a Screenshot

!wd screenshot [outputPath]

Example Project

Project Structure

your_project/
├── mcp-client-<version>.jar
├── mcp-server-<version>.jar
└── conf/
    └── mcp-config.json

Configuration File mcp-config.json

{
  "servers": [
    {
      "name": "chrome",
      "host": "localhost",
      "port": 4444,
      "browser": "chrome"
    }
  ]
}

API Documentation

Class Element

• getId(): Get the element id.
• getCss(): Find an element using a CSS selector.
• getXpath(): Find an element using an XPath expression.

Interface IWebDriver

• navigate(String url): Navigate to the specified URL.
• closeWindow(): Close the current window.

📄 License

The MCP project is licensed under the MIT License.