内容
# 奥诺德 MCP — 面向 AI 代理的浏览器自动化
[](https://www.npmjs.com/package/mcp-ornold-browser)
基于 AI 的浏览器自动化，支持反检测浏览器、验证码破解和流程录制。
**支持：** Claude Code, Cursor, VS Code Copilot, Windsurf, Cline, Codex
## 功能概述
- **控制反检测浏览器** — Linken Sphere, Dolphin Anty, Wade X/Wadex, Vision Browser, AdsPower, Octo Browser, Multilogin, MoreLogin, 0DETECT, GoLogin, Undetectable, Incogniton, Indigo
- **视觉优先交互** — 截图 → AI 元素检测 → 坐标点击（无需 CSS 选择器）
- **验证码破解** — reCAPTCHA, hCaptcha, Cloudflare Turnstile, PerimeterX 等
- **流程录制与重放** — 录制一次，在 100+ 个浏览器上并行重放
- **类似人类行为** — 贝塞尔鼠标曲线，高斯打字延迟，行为配置文件
---
## 🚀 安装 — 复制并粘贴到您的代理
选择您的代理，复制下面的消息，并将其粘贴到聊天中。代理将完成其余的操作。
### Claude Code
```
安装 Ornold MCP — 面向反检测浏览器的浏览器自动化。
要求：Node.js ≥ 18 (https://nodejs.org)
令牌：请在 https://mcp.ornold.com 获取（注册 → 令牌页面 → 创建令牌）
运行以下两个命令：
1. claude mcp add --transport stdio ornold-browser -- npx mcp-ornold-browser --token YOUR_TOKEN --mode vision
2. npx mcp-ornold-browser --install-skill
将 YOUR_TOKEN 替换为仪表盘中的令牌。第一个命令添加 MCP 服务器（推荐视觉模式以防反检测），第二个命令安装 AI 技能，有效地教会您如何使用浏览器工具。
如果您需要视觉和 DOM 模式，请创建两个独立的服务器：
1. claude mcp add --transport stdio ornold-vision -- npx mcp-ornold-browser --token YOUR_TOKEN --mode vision
2. claude mcp add --transport stdio ornold-dom -- npx mcp-ornold-browser --token YOUR_TOKEN --mode dom
3. npx mcp-ornold-browser --install-skill
设置完成后，通过调用 browser_status 工具进行验证。
```
### Cursor
```
安装 Ornold MCP — 面向反检测浏览器的浏览器自动化。
要求：Node.js ≥ 18 (https://nodejs.org)
令牌：请在 https://mcp.ornold.com 获取（注册 → 令牌页面 → 创建令牌）
创建或编辑文件 ~/.cursor/mcp.json 并添加此配置：
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--mode", "vision"]
}
}
}
将 YOUR_TOKEN 替换为仪表盘中的令牌。如果文件中已有其他服务器，请将 ornold-browser 条目合并到现有的 mcpServers 对象中。保存后重启 Cursor。
对于两种模式，创建两个条目（ornold-vision 带有 --mode vision，ornold-dom 带有 --mode dom）。
```
### VS Code (Copilot)
```
安装 Ornold MCP — 面向反检测浏览器的浏览器自动化。
要求：Node.js ≥ 18 (https://nodejs.org)
令牌：请在 https://mcp.ornold.com 获取（注册 → 令牌页面 → 创建令牌）
运行此命令：
code --add-mcp '{"name":"ornold-browser","command":"npx","args":["mcp-ornold-browser","--token","YOUR_TOKEN","--mode","vision"]}'
或在项目根目录中创建 .vscode/mcp.json：
{
"servers": {
"ornold-browser": {
"type": "stdio",
"command": "npx",
"args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--mode", "vision"]
}
}
}
将 YOUR_TOKEN 替换为仪表盘中的令牌。
```
### Windsurf
```
安装 Ornold MCP — 面向反检测浏览器的浏览器自动化。
要求：Node.js ≥ 18 (https://nodejs.org)
令牌：请在 https://mcp.ornold.com 获取（注册 → 令牌页面 → 创建令牌）
前往 Windsurf 设置 → 工具 → 添加 MCP 服务器并粘贴此配置：
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--mode", "vision"]
}
}
}
将 YOUR_TOKEN 替换为仪表盘中的令牌。
```
### Cline
```
安装 Ornold MCP — 面向反检测浏览器的浏览器自动化。
要求：Node.js ≥ 18 (https://nodejs.org)
令牌：请在 https://mcp.ornold.com 获取（注册 → 令牌页面 → 创建令牌）
打开 Cline 侧边栏 → MCP → 添加并粘贴：
{
"mcpServers": {
"ornold-browser": {
"command": "npx",
"args": ["mcp-ornold-browser", "--token", "YOUR_TOKEN", "--mode", "vision"],
"disabled": false
}
}
}
将 YOUR_TOKEN 替换为仪表盘中的令牌。
```
### Codex (CLI & Desktop)
```
安装 Ornold MCP — 面向反检测浏览器的浏览器自动化。
要求：Node.js ≥ 18 (https://nodejs.org)
令牌：请在 https://mcp.ornold.com 获取（注册 → 令牌页面 → 创建令牌）
创建或编辑 ~/.codex/config.toml 并添加：
[mcp_servers.ornold-browser]
command = "npx"
args = ["-y", "mcp-ornold-browser", "--token", "YOUR_TOKEN", "--mode", "vision"]
将 YOUR_TOKEN 替换为仪表盘中的令牌。
注意：桌面应用程序不会继承终端 PATH。如果 MCP 无法启动，请使用 `which npx` 查找您的 npx 路径，并在命令字段中使用完整路径。
```
---
## 反检测浏览器设置
安装 MCP 服务器后，通过在参数中添加标志来连接您的反检测浏览器。
| 浏览器 | 添加到参数 | 环境别名 | 备注 |
|---------|-------------|-------------|-------|
| **Linken Sphere** | `"--linken-port", "40080"` | `LINKEN_PORT` | 本地 API 端口 |
| **Dolphin Anty** | `"--dolphin-port", "3001", "--dolphin-token", "TOKEN"` | `DOLPHIN_PORT`, `DOLPHIN_API_TOKEN` | 本地启动/停止和云配置文件 API |
| **Wade X / Wadex** | `"--wadex-port", "8080"` | `WADEX_PORT` | 本地 API 端口 |
| **Vision Browser** | `"--vision-token", "TOKEN", "--vision-port", "PORT"` | `VISION_TOKEN`, `VISION_PORT` | 需要令牌；本地端口可选 |
| **AdsPower** | `"--adspower-url", "http://local.adspower.net:50325"` | `ADSPOWER_URL`, `ADSPOWER_LOCAL_API_URL`, `ADSPOWER_KEY`, `ADSPOWER_API_KEY` | 本地 API；如果您的设置需要它，则需要密钥 |
| **Octo Browser** | `"--octo-token", "TOKEN", "--octo-url", "http://127.0.0.1:58888"` | `OCTO_TOKEN`, `OCTO_API_TOKEN`, `OCTO_URL`, `OCTO_LOCAL_API_URL` | 云配置文件 API 的令牌；本地 URL 用于启动/停止 |
| **Multilogin** | `"--multilogin-token", "TOKEN", "--multilogin-url", "http://127.0.0.1:35000"` | `MULTILOGIN_TOKEN`, `MULTILOGIN_API_TOKEN`, `MULTILOGIN_LOCAL_API_URL` | 支持云、本地、代理和 cookie 端点 |
| **MoreLogin** | `"--morelogin-port", "40000"` 或 `"--morelogin-url", "http://127.0.0.1:40000"` | `MORELOGIN_PORT`, `MORELOGIN_URL`, `MORELOGIN_LOCAL_API_URL` | 本地 API |
| **0DETECT** | `"--detect0-port", "PORT", "--detect0-token", "TOKEN"` | `DETECT0_PORT`, `DETECT0_URL`, `DETECT0_LOCAL_API_URL`, `DETECT0_TOKEN`, `DETECT0_API_TOKEN` | 本地 API；令牌可选，适用于需要身份验证的设置 |
| **GoLogin** | `"--gologin-token", "TOKEN"` | `GOLOGIN_TOKEN`, `GOLOGIN_API_TOKEN`, `GOLOGIN_URL`, `GOLOGIN_API_URL` | 云 API |
| **Undetectable** | `"--undetectable-port", "25325"` 或 `"--undetectable-url", "http://127.0.0.1:25325"` | `UNDETECTABLE_PORT`, `UNDETECTABLE_URL`, `UNDETECTABLE_LOCAL_API_URL` | 本地 API |
| **Incogniton** | `"--incogniton-port", "35000"` 或 `"--incogniton-url", "http://127.0.0.1:35000"` | `INCOGNITON_PORT`, `INCOGNITON_URL`, `INCOGNITON_LOCAL_API_URL` | 本地 API |
| **Indigo Browser** | `"--indigo-token", "TOKEN"` | `INDIGO_TOKEN`, `INDIGO_API_TOKEN`, `INDIGO_URL`, `INDIGO_API_URL` | 云 API |
**Octo Browser 示例：**
```bash
claude mcp add --transport stdio ornold-octo -- npx -y mcp-ornold-browser@latest --token TOKEN --mode vision --octo-token OCTO_TOKEN --octo-url http://127.0.0.1:58888
```
**AdsPower 示例：**
```bash
claude mcp add --transport stdio ornold-adspower -- npx -y mcp-ornold-browser@latest --token TOKEN --mode vision --adspower-url http://local.adspower.net:50325
```
### 交互模式
在参数中添加 `"--mode", "MODE"`：
- **`dom`** — 快速，使用 DOM 快照
- **`vision`** — 截图 + AI 元素检测，最适合反检测隐身
- **`both`** — 两种模式均可用（不推荐 — 加载太多工具，代理会混淆）
对于反检测浏览器自动化，请使用 `vision` 模式。
### 最佳实践：独立的 MCP 服务器
为每种模式和每种反检测浏览器创建一个独立的 MCP 服务器。这可以保持工具列表较小 — 代理更可靠地选择正确的工具。
**Claude Code 示例（两种模式 + Linken Sphere）：**
```bash
claude mcp add --transport stdio ornold-vision -- npx mcp-ornold-browser --token TOKEN --mode vision --linken-port 40080
claude mcp add --transport stdio ornold-dom -- npx mcp-ornold-browser --token TOKEN --mode dom --linken-port 40080
```
**Cursor 示例（两种反检测浏览器）：**
```json
{
"mcpServers": {
"ornold-linken": {
"command": "npx",
"args": ["-y", "mcp-ornold-browser@latest", "--token", "TOKEN", "--mode", "vision", "--linken-port", "40080"]
},
"ornold-octo": {
"command": "npx",
"args": ["-y", "mcp-ornold-browser@latest", "--token", "TOKEN", "--mode", "vision", "--octo-token", "OCTO_TOKEN", "--octo-url", "http://127.0.0.1:58888"]
}
}
}
```
---
## 安装技能（推荐）
技能教会 AI 代理如何正确使用 Ornold 工具。没有它们，代理可能会使用 JavaScript 注入而不是类似人类的逐字符输入，或者跳过视觉工作流。
| 代理 | 命令 |
|-------|---------|
| **Claude Code** | `npx mcp-ornold-browser --install-skill` |
| **Cursor** | 复制 `skills/.cursorrules` 到项目根目录 |
| **Windsurf** | 复制 `skills/.windsurfrules` 到项目根目录 |
| **Cline** | 复制 `skills/.clinerules` 到项目根目录 |
| **VS Code Copilot** | 复制 `skills/copilot-instructions.md` 到 `.github/copilot-instructions.md` |
| **Codex** | 自动读取 `AGENTS.md` |
完整工具参考示例：[`skills/ornold-browser.md`](skills/ornold-browser.md)
---
## 工具示例
### 输入文本（类似人类，逐字符）
```
browser_parallel_type({selector: "[ref=3]", text: "user@mail.com"})
```
每个字符都通过 CDP keyDown/char/keyUp 以及大写字母和符号的 Shift 键输入，在按键之间有高斯延迟，并且有每个浏览器的输入配置文件。永远不要使用 JavaScript 设置输入值。
### 视觉模式 — 看见并点击
```
browser_parallel_vision_analyze_grouped() → AI 检测带有 [x1,y1,x2,y2] 框的元素
browser_parallel_click_normalized_box({box: [0.35, 0.72, 0.65, 0.78]}) → 使用贝塞尔鼠标点击
```
### 使用每个浏览器的数据填充表单
```
browser_parallel_fill_multi({
selector: "input[name=email]",
values: {"browser1": "user1@mail.com", "browser2": "user2@mail.com"}
})
```
### 破解验证码
```
browser_solve_captcha() → 检测类型，解决，注入令牌 — 全部自动
```
### 录制和重放流程
```
browser_start_recording()
// ... 执行操作 ...
browser_stop_recording()
browser_edit_flow({editStep: 3, editFields: {text: "{{row.email}}"}})
browser_save_flow({name: "Registration"})
browser_run_flow({flowId: "fl_abc", dataset: [{email: "a@b.com"}]})
```
---
## 功能
### 视觉优先交互
Ornold 使用截图 + AI 元素检测，而不是脆弱的 CSS 选择器。代理在视觉上看到页面并通过坐标点击 — 就像人类一样。这避免了由于 DOM 操作而触发的机器人检测。
### 流程录制与重放
一次记录浏览器自动化序列，然后在数百个配置文件中重放：
1. 开始录制
2. 执行操作（导航，点击，输入，解决验证码）
3. 使用模板变量保存流程（`{{row.email}}`，`{{row.password}}`）
4. 使用数据集运行 — 每个浏览器获取唯一数据
### 并行执行
所有操作同时在所有连接的浏览器配置文件上运行。启动 50 个会话，将它们全部导航到不同的 URL，并用每个配置文件的唯一数据填充表单。
### 验证码破解
自动检测和解决：reCAPTCHA v2/v3，hCaptcha，Cloudflare Turnstile，GeeTest，FunCaptcha，Amazon WAF，PerimeterX 按下并保持等。
### 类似人类行为
服务器自动生成：
- 贝塞尔曲线鼠标移动
- 高斯分布的打字延迟
- 每个浏览器的行为配置文件
- 随机交互模式
无需添加人工延迟 — 所有功能都已内置。
---
## 获取您的令牌
1. 前往 [mcp.ornold.com](https://mcp.ornold.com)
2. 注册或登录
3. 导航到 **令牌** 页面
4. 创建新令牌
5. 复制并粘贴到配置中
---
## 链接
- **仪表盘与令牌**: [mcp.ornold.com](https://mcp.ornold.com)
- **网站**: [ornold.com](https://ornold.com)
- **npm**: [mcp-ornold-browser](https://www.npmjs.com/package/mcp-ornold-browser)
## 许可证
MIT
