# @angiejones/mcp-selenium 中文文档

规范地址：https://npmcn.com/package/%40angiejones/mcp-selenium/

版本：0\.2\.3
npm 元数据更新时间：2026-02-23T03:24:36.076Z
中文译文更新时间：2026-11-06T13:36:34.632Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40angiejones/mcp-selenium
原文对照：https://npmcn.com/package/%40angiejones/mcp-selenium/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：120 kB，33 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2025-02-12T06:23:44.425Z
- 最新版本发布：2026-02-23T03:24:35.935Z
- 近 30 天下载量：3110（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 4 个）

## 中文简介

硒WebDriver MCP 服务器

## 安装

```sh
npm install @angiejones/mcp-selenium
```

也可以使用：`pnpm add @angiejones/mcp-selenium`、`yarn add @angiejones/mcp-selenium`、`bun add @angiejones/mcp-selenium`

## README

# MCP 硒服务器

一个用于硒 WebDriver的模型上下文协议(MCP)服务器——AI代理的浏览器自动化.

[![Watch the video](https://img.youtube.com/vi/mRV0N8hcgYA/sddefault.jpg)](https://youtu.be/mRV0N8hcgYA)

[![Selenium MCP server](https://glama.ai/mcp/servers/@angiejones/mcp-selenium/badge)](https://glama.ai/mcp/servers/@angiejones/mcp-selenium)

## 设置

**鹅 (德克托克)**

粘贴到您的浏览器地址栏 :

```
goose://extension?cmd=npx&arg=-y&arg=%40angiejones%2Fmcp-selenium%40latest&id=selenium-mcp&name=Selenium%20MCP&description=automates%20browser%20interactions
```
**鹅 (CLI)**

```bash
goose session --with-extension "npx -y @angiejones/mcp-selenium@latest"
```
**克劳德代码**

```bash
claude mcp add selenium -- npx -y @angiejones/mcp-selenium@latest
```
**Cursor / Windsurf / 其他 MCP 客户端**

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

## 示例使用

告诉你选择的人工智能特工:

> 打开Chrome,去github.com/angiejones,并取出截图.

特工会给Selenium的API打电话 `start_browser`, (中文(简体) ), `navigate`,以及 `take_screenshot`。不需要手动脚本或明确的方向.

## 支持的浏览器

Chrome),Firefox,Edge,和萨法里.

> **Safari 注:** 需要 macOS 。 (笑声) 运行 `sudo safaridriver --enable` 一次并启用 Safari 中的"Allow远程自动化" → 设置 → 开发者. 没有无头模式 .

* * *

**工具**

### 开始浏览器( b)

启动浏览器会话 .

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 浏览器 | 字符串 | 对 | `chrome`, (中文(简体) ), `firefox`, (中文(简体) ), `edge`,或 `safari` |
| 选项 | 对象 | 没有 | `{ headless: boolean, arguments: string[] }` |

### 导航

导航到 URL.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| url 密码 | 字符串 | 对 | 要导航的 URL |

### 交互

在元素上执行鼠标动作.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 动作 | 字符串 | 对 | `click`, (中文(简体) ), `doubleclick`, (中文(简体) ), `rightclick`,或 `hover` |
| 以 | 字符串 | 对 | 定位战略: `id`, (中文(简体) ), `css`, (中文(简体) ), `xpath`, (中文(简体) ), `name`, (中文(简体) ), `tag`, (中文(简体) ), `class` |
| 价值 | 字符串 | 对 | 定位战略的价值 |
| 超时 | 编号 | 没有 | 最大等数以毫秒( 默认值: 1 000) |

### 发送密钥

将文本输入元素。 先清净地.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 以 | 字符串 | 对 | 定位战略 |
| 价值 | 字符串 | 对 | 定位值 |
| 文本 | 字符串 | 对 | 要输入的文本 |
| 超时 | 编号 | 没有 | 最大等数以毫秒( 默认值: 1 000) |

### 获取元素 text

获取元素的文本内容.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 以 | 字符串 | 对 | 定位战略 |
| 价值 | 字符串 | 对 | 定位值 |
| 超时 | 编号 | 没有 | 最大等数以毫秒( 默认值: 1 000) |

### 获取元素 属性

从元素中获取属性值.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 以 | 字符串 | 对 | 定位战略 |
| 价值 | 字符串 | 对 | 定位值 |
| 属性 | 字符串 | 对 | 属性名称( 例如 ), `href`, (中文(简体) ), `value`, (中文(简体) ), `class`(中文(简体) ) |
| 超时 | 编号 | 没有 | 最大等数以毫秒( 默认值: 1 000) |

### 按键

按键盘键.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 键 | 字符串 | 对 | 要按的密钥( 例如 ), `Enter`, (中文(简体) ), `Tab`, (中文(简体) ), `a`(中文(简体) ) |

### 上传文件( f)

通过文件输入元素上传文件.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 以 | 字符串 | 对 | 定位战略 |
| 价值 | 字符串 | 对 | 定位值 |
| 文件路径 | 字符串 | 对 | 文件的绝对路径 |
| 超时 | 编号 | 没有 | 最大等数以毫秒( 默认值: 1 000) |

### 抓取屏幕截图( s)

抓取当前页面的截图.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 输出Path | 字符串 | 没有 | 保存路径 。 如果省略,则返回基础64图像数据. |

### 关闭会话( c)

关闭当前浏览器会话 。 无参数 .

### 执行( c)

在浏览器中执行 JavaScript 。 用于其他工具未覆盖的高级交互(如拖放,滚动,读取计算样式,DOM操作等).

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 脚本 | 字符串 | 对 | 要执行的 JavaScript 代码 |
| 参数 | 数组 | 没有 | 可通过 `arguments[0]`等 (中文(简体) ). |

### 窗口

管理浏览器窗口和标签.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 动作 | 字符串 | 对 | `list`, (中文(简体) ), `switch`, (中文(简体) ), `switch_latest`,或 `close` |
| 控件 | 字符串 | 没有 | 窗口手柄( 需要用于 `switch`(中文(简体) ) |

### 边框

切换焦点到帧或返回主页.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 动作 | 字符串 | 对 | `switch` 或者说 `default` |
| 以 | 字符串 | 没有 | 定位战略 `switch`(中文(简体) ) |
| 价值 | 字符串 | 没有 | 定位器值(用于 `switch`(中文(简体) ) |
| 指数 | 编号 | 没有 | 框架指数,基于 0(用于 `switch`(中文(简体) ) |
| 超时 | 编号 | 没有 | 最大等数以毫秒( 默认值: 1 000) |

### 警报

处理浏览器提醒,确认,或提示对话框 .

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 动作 | 字符串 | 对 | `accept`, (中文(简体) ), `dismiss`, (中文(简体) ), `get_text`,或 `send_text` |
| 文本 | 字符串 | 没有 | 要发送的文本( 需要 `send_text`(中文(简体) ) |
| 超时 | 编号 | 没有 | 最大以 ms 等 (默认: 5000) |

### 添加 cookie( c)

加个饼干 浏览器必须在从饼干域的一页上.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 名称 | 字符串 | 对 | Cookie 名称 |
| 价值 | 字符串 | 对 | Cookie 值 |
| 域名 | 字符串 | 没有 | Cookie 域名 |
| 路径 | 字符串 | 没有 | Cookie 路径 |
| 安全 | 布尔 | 没有 | 安全旗帜 |
| 仅限 httply | 布尔 | 没有 | HTTP 唯一旗帜 |
| 过期 | 编号 | 没有 | 无九时戳 |

### 获取小饼干

得到饼干。 按名称返回全部或特定名称.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 名称 | 字符串 | 没有 | 饼干的名字。 所有饼干都给我吃. |

### 删除cookie

删除 cookie 。 删除全部或特定名称.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 名称 | 字符串 | 没有 | 饼干的名字。 关闭删除所有. |

### 诊断

获得通过WebDriver BiDi(支持时自动启用)捕获的浏览器诊断.

| 参数 | 类型 | 需求 | 说明 |
| --- | --- | --- | --- |
| 类型 | 字符串 | 对 | `console`, (中文(简体) ), `errors`,或 `network` |
| 清除 | 布尔 | 没有 | 返回后清除缓冲( 默认: 假) |

**资源**

MCP资源提供只读数据,客户端无需调用工具即可访问.

### 浏览器状态/ 当前

返回当前浏览器会话状态(活动会话ID或"没有活动会话").

| 财产 | 数值 |
| --- | --- |
| MIME 类型 | `text/plain` |
| 需要浏览器 | 没有 |

### 无障碍/当前

返回当前页面的可访问树快照——一个结构紧凑的JSON交互式元素和文本内容的描述. 比完整的HTML小得多. 用于理解页面布局并找到与之互动的元素 .

| 财产 | 数值 |
| --- | --- |
| MIME 类型 | `application/json` |
| 需要浏览器 | 对 |

* * *

**发展**

### 设置

```bash
git clone https://github.com/angiejones/mcp-selenium.git
cd mcp-selenium
npm install
```

### 运行测试

```bash
npm test
```

要求在 PATH 上使用 Chrome + 铬化相机。 测试是无头的.

### 通过 Smithery 安装

```bash
npx -y @smithery/cli install @angiejones/mcp-selenium --client claude
```

### 全球安装

```bash
npm install -g @angiejones/mcp-selenium
mcp-selenium
```

## 许可证

麻省理工学院

## 常见问题

### @angiejones/mcp-selenium 是什么？

硒WebDriver MCP 服务器

### 如何安装 @angiejones/mcp-selenium？

在项目目录运行 npm install @angiejones/mcp-selenium，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-selenium，可以用 npx mcp-selenium 直接运行。

### @angiejones/mcp-selenium 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/angiejones\_\_mcp-selenium 是否存在。

### @angiejones/mcp-selenium 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @angiejones/mcp-selenium 可以商用吗？

@angiejones/mcp-selenium 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @angiejones/mcp-selenium 的下载量有多少？

根据 npm 官方下载统计，@angiejones/mcp-selenium 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,110 次，日均约 104 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @angiejones/mcp-selenium 还在维护吗？

最新版本 0\.2\.3 发布于 2026/02/23（8 个月前）；至今共发布 21 个版本，其中过去 12 个月发布了 4 个；首次发布于 2025/02/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。