selenium-mcp让Claude Code通过真实浏览器编写精准Selenium测试

Install selenium-mcp to give Claude Code a real browser.

它能编写标准 Selenium 测试，使用实时页面检查得到的精准定位器，无缝集成到你现有的 Java 项目中。

What Changed — selenium-mcp 让 Claude Code 能"看见"你的页面

If you've ever asked Claude Code to write a Selenium test, you know the pain: it guesses locators from pasted HTML, misses dynamic elements, and produces tests that fail on the first run.

如果你曾经让 Claude Code 写 Selenium 测试，你一定体会过这种痛苦：它根据粘贴的 HTML 猜测定位器，遗漏动态元素，生成的测试一跑就失败。

selenium-mcp (github.com/Volta-Jebaprashanth/selenium-mcp) fixes that by giving your AI agent a real Selenium WebDriver session it can drive directly.

selenium-mcp（github.com/Volta-Jebaprashanth/selenium-mcp）解决了这个问题——它为你的 AI Agent 提供一个可直接操控的真实 Selenium WebDriver 会话。

It's a Java-based MCP server that exposes 112 tools across 16 categories—including openBrowser, navigate, getPageElementsFiltered, waitForNetworkIdle, and REST Assured API tools.

这是一个基于 Java 的 MCP 服务器，暴露了 112 个工具，涵盖 16 个类别——包括 openBrowser、navigate、getPageElementsFiltered、waitForNetworkIdle 以及 REST Assured API 工具。

Instead of hallucinating selectors, Claude Code inspects the live DOM, gets disambiguated locators, and writes tests that actually work. The output is plain Java with standard Selenium—no proprietary runtime dependency.

Claude Code 不再凭空杜撰选择器，而是检查真实 DOM，获取经过消歧的定位器，编写出真正能用的测试。输出的是纯 Java 代码和标准 Selenium——没有任何专有运行时依赖。

What It Means For You — No more guessing locators

对于测试自动化工程师来说，这是一个游戏规则的改变者。现在你可以让 Claude Code：

• Inspect a page and write a test — Claude 打开 Chrome，导航到你的预发布环境 URL，用 getPageElementsFiltered 找到邮箱和密码字段，然后用你现有的 Page Object 风格编写一个 LoginPageTest 类。

• Diagnose flaky tests — 使用 NetworkTools 如 waitForNetworkIdle 和 getNetworkLog 精确定位时序问题。

• Refactor brittle locators — 让 Claude 对准现有的 Page Object，用实时元素发现来改进选择器。

Since Claude works in your Maven project, it follows your conventions—TestNG, JUnit 5, whatever you use—and writes files directly into src/test/java.

由于 Claude 在你的 Maven 项目中工作，它遵循你的规范——无论你用的是 TestNG 还是 JUnit 5——并直接将文件写入 src/test/java。

Try It Now — Setup and your first prompt

Step 1: Download the jar — Grab the latest release from GitHub. You need Java 21+ and a local Chrome, Firefox, or Edge (WebDriver binaries auto-fetch).

步骤 1：下载 jar 包 — 从 GitHub 获取最新版本。需要 Java 21+ 和本地 Chrome、Firefox 或 Edge（WebDriver 二进制文件会自动获取）。

Step 2: Add to Claude Code config — Add this to your MCP server config (e.g., ~/.claude.json or project .mcp.json):

步骤 2：添加到 Claude Code 配置 — 将以下内容添加到你的 MCP 服务器配置中（如 ~/.claude.json 或项目 .mcp.json）：

{
  "mcpServers": {
    "selenium-mcp": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/selenium-mcp.jar"]
    }
  }
}

Step 3: Open Claude Code in your Maven project — Ensure you're in the workspace with your existing Java/Selenium tests.

步骤 3：在 Maven 项目中打开 Claude Code — 确保你在包含现有 Java/Selenium 测试的工作区中。

Step 4: Prompt for a real test — Try this:

步骤 4：用自然语言描述一个真实测试 — 试试这个：

"Open Chrome and navigate to our staging login page at https://staging.example.com/login. Inspect the email and password fields using the page element tools, then write a LoginPageTest class in our existing LoginPage Page Object style, using TestNG, that logs in with a valid test user and asserts we land on the dashboard."

观察工具调用：openBrowser、navigate、getPageElementsFiltered。Claude 会用真实定位器编写测试并等待。

Step 5: Run and review — Run mvn test and review the output like a teammate's PR. It's standard Selenium code.

步骤 5：运行并审查 — 运行 mvn test，像审查队友的 PR 一样查看输出。这是标准的 Selenium 代码。

Go further: Ask Claude to add REST Assured API checks via ApiTools, or debug a flaky test with NetworkTools.

更进一步：让 Claude 通过 ApiTools 添加 REST Assured API 检查，或用 NetworkTools 调试不稳定的测试。

Why It Works — Seeing beats guessing

The core problem with AI-generated tests is hallucinated selectors. selenium-mcp gives Claude a live browser session, so it can query the actual DOM, get ancestor/sibling-disambiguated locators, and verify element visibility. Combined with CDP network tools, it can even wait for network idle—addressing the #1 cause of flaky tests.

AI 生成测试的核心问题是选择器凭空杜撰。selenium-mcp 为 Claude 提供了一个真实浏览器会话，所以它可以查询真实 DOM，获取经过祖先/兄弟节点消歧的定位器，并验证元素可见性。结合 CDP 网络工具，它甚至可以等待网络空闲——解决不稳定测试的首要原因。

Is This For You?

你是目标用户吗？

• You're writing new Selenium tests and want them right the first time.
• 你在编写新的 Selenium 测试，希望一次就写对。
• You have flaky tests that need diagnosis.
• 你有不稳定的测试需要诊断。
• You're refactoring Page Objects and want accurate locators.
• 你在重构 Page Objects，想要精准的定位器。

Skip it if you're not on Java/Selenium—this is built specifically for that stack.

如果不使用 Java/Selenium 可以跳过——这个工具是专门为这个技术栈打造的。

Originally published on gentic.news