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 许可证。