AM

angiejones/mcp-selenium

浏览器自动化

本页由 AI 翻译,技术细节请以原文为准。 查看原文

430 stars 121 forks 质量 71 趋势 20MIT

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 --enable once 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[] }

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
在 GitHub 查看完整 README

安装

npx -y @angiejones/mcp-selenium@latest
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "selenium": { "command": "npx", "args": ["-y", "@angiejones/mcp-selenium@latest"] } } }