
Selenium WebDriver 的 MCP 实现
概览
Selenium WebDriver 的模型上下文协议(MCP)服务器——用于 AI 代理的浏览器自动化。 打开Chrome,进入 github.com/angiejones,截图。 代理会调用 Selenium 的 API,进行 start_browser、导航和take_screenshot。无需手动脚本或明确指示。 需要macOS。运行sudo safaridriver——启用一次,并在开发者→设置中启用“允许远程自动化”→。没有无头模式。 在元素中输入文本。先清除字段。 从一个元素获得属性值。 通过文件输入元素上传文件。 截取当前页面的截图。
概述(AI 翻译)
Selenium WebDriver 的模型上下文协议(MCP)服务器——用于 AI 代理的浏览器自动化。
布置
Goose(桌面版)
粘贴到你的浏览器地址栏:
鹅(CLI)
克劳德密码
光标 / 风帆冲浪 / 其他 MCP 客户端
示例用法
告诉你选择的AI代理:
打开Chrome,进入 github.com/angiejones,截图。
代理会调用 Selenium 的 API,分别调用 start_browser、navigate 和 take_screenshot。无需手动脚本或明确指令。
支持的浏览器
Chrome、Firefox、Edge 和 Safari。
Safari 注: 需要 macOS。运行一次
sudo safaridriver --enable并启用 在 Safari → 设置→开发者里“允许远程自动化”。没有无头模式。
工具
start_browser
启动浏览器会话。
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| 浏览器 | 字符串 | 是的 | chrome, firefox, edge 或 safari |
| 选项 | 对象 | 无 | { headless: boolean, arguments: string[] } |
导航
导航到一个网址。
| 参数 | 类型 | 必需 | 描述 |
|---|
本页由 AI 翻译,技术细节请以原文为准。
README
以下为原文 README 节选,完整内容请查看原文。
MCP Selenium Server
A Model Context Protocol (MCP) server for Selenium WebDriver — browser automation for AI agents.
Setup
Example Usage
Tell the AI agent of your choice:
Open Chrome, go to github.com/angiejones, and take a screenshot.
The agent will call Selenium’s APIs to start_browser, navigate, and take_screenshot. No manual scripting or explicit directions needed.
Supported Browsers
Chrome, Firefox, Edge, and Safari.
Safari note: Requires macOS. Run
sudo safaridriver --enableonce and enable “Allow Remote Automation” in Safari → Settings → Developer. No headless mode.
start_browser
Launches a browser session.
| Parameter | Type | Required | Description |
|---|---|---|---|
| browser | string | Yes | chrome, firefox, edge, or safari |
| options | object | No | { headless: boolean, arguments: string[] } |
navigate
Navigates to a URL.
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | URL to navigate to |
interact
Performs a mouse action on an element.
| Parameter | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | click, doubleclick, rightclick, or hover |
| by | string | Yes | Locator strategy: id, css, xpath, name, tag, class |
| value | string | Yes | Value for the locator strategy |
| timeout | number | No | Max wait in ms (default: 10000) |
send_keys
Types text into an element. Clears the field first.
| Parameter | Type | Required | Description |
|---|---|---|---|
| by | string | Yes | Locator strategy |
| value | string | Yes | Locator value |
| text | string | Yes | Text to enter |
安装
npx -y @angiejones/mcp-selenium@latest配置
{
"mcpServers": {
"selenium": {
"command": "npx",
"args": ["-y", "@angiejones/mcp-selenium@latest"]
}
}
}