Selenium

🚀 MCP Selenium WebDriver 使用說明

MCP 是用於控制 Selenium WebDriver 的協議，藉助 TCP 通信可向遠程 WebDriver 實例發送命令，為自動化測試等場景提供便利。

🚀 快速開始

MCP 是一個用於控制 Selenium WebDriver 的協議，它允許通過 TCP 通信向遠程 WebDriver 實例發送命令。下面將為你介紹如何使用 MCP。

✨ 主要特性

• 支持通過 TCP 通信向遠程 WebDriver 實例發送命令。
• 提供了豐富的常用命令，如獲取元素信息、點擊元素、輸入文本等。
• 有詳細的 API 文檔，方便開發者進行二次開發。

📦 安裝指南

下載 MCP

可從 MCP 官方網站 下載最新版本的 MCP。

安裝步驟

1. 解壓下載的文件。
2. 將 mcp-server.jar 和 WebDriver 執行文件（如 chromedriver.exe）置於同一目錄。
3. 運行以下命令啟動 MCP 服務器：

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

💻 使用示例

基礎用法

import org.openqa.selenium.WebDriver;

public class Example {
    public static void main(String[] args) {
        WebDriver driver = new ChromeDriver();
        driver.navigate("https://www.example.com");
        
        // 查找元素並點擊
        WebElement button = driver.findElement(By.cssSelector("#submit-btn"));
        button.click();
        
        // 輸入文本
        WebElement input = driver.findElement(By.id("search-box"));
        input.sendKeys("搜索內容");
        
        driver.closeWindow();
    }
}

📚 詳細文檔

常用命令

獲取元素信息

!wd getelementinfo <selector> [attribute]

• 參數：
  • <selector>：元素選擇器（如 id、css、xpath）
  • [attribute]：可選，要獲取的屬性名。

點擊元素

!wd click <selector>

輸入文本

!wd type <selector> <text>

提交表單

!wd submit <selector>

獲取頁面標題

!wd gettitle

檢查元素是否存在

!wd elementexists <selector>

截取屏幕截圖

!wd screenshot [outputPath]

示例項目

項目結構

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

配置文件 mcp-config.json

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

🔧 技術細節

API 文檔

類 Element

• getId()：獲取元素 id。
• getCss()：使用 CSS 選擇器查找元素。
• getXpath()：使用 XPath 表達式查找元素。

接口 IWebDriver

• navigate(String url)：導航到指定 URL。
• closeWindow()：關閉當前窗口。

📄 許可證

MCP 項目遵循 MIT 許可證。