MCP Selenium WebDriver 使用说明

简介

MCP 是一个用于控制 Selenium WebDriver 的协议。它允许通过 TCP 通信发送命令到远程WebDriver 实例。

安装指南

下载 MCP

从 MCP 官方网站 下载最新版本的 MCP。

安装步骤

1. 解压下载的文件。
2. 将 mcp-server.jar 和 WebDriver 执行文件（如 chromedriver.exe）放在同一目录中。
3. 运行命令启动 MCP 服务器：

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

常用命令

获取元素信息

!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()：关闭当前窗口。

使用示例

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();
    }
}

许可证

MCP 项目遵循 MIT 许可证。