Browser MCP

浏览器 MCP 服务

一个模型上下文协议（MCP）服务，使用 Anchor Browser 的远程浏览器服务和 Playwright 提供浏览器自动化功能。该服务让大模型能够通过 Anchor 的云端浏览器与网页交互，并使用内置代理、隐身功能和高级能力。

主要功能

• 远程浏览器执行：使用 Anchor Browser 的云基础设施，而非本地浏览器
• 内置代理：自动轮换住宅代理并支持地理定位
• 隐身与反检测：高级浏览器指纹识别和反机器人检测
• 快速且轻量：使用 Playwright 的无障碍树，而非基于像素的输入
• 适用于大模型：无需视觉模型，完全基于结构化数据运行
• 确定性的工具操作：避免基于屏幕截图的方法常见的模糊性

要求

• Node.js 18 或更高版本
• Anchor Browser API 密钥（在此获取）
• VS Code、Cursor、Windsurf、Claude Desktop、Goose 或其他 MCP 客户端

快速开始

1. 克隆并构建

由于这是一个自定义浏览器 MCP 服务，你需要在本地构建：

# Clone the repository
git clone https://github.com/anchorbrowser/anchor-mcp.git
cd anchor-mcp

# Install dependencies and build
npm install
npm run build

2. 获取 Anchor API 密钥

1. 在 anchorbrowser.io 注册
2. 从控制面板获取 API 密钥
3. 复制 API 密钥（以 sk- 开头）

3. 配置 MCP 客户端

Cursor

添加到你的 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

VS Code

添加到你的 MCP 配置中：

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

4. 重启 MCP 客户端

更新配置后，重启 MCP 客户端（Cursor、VS Code 等）以加载新服务。

配置选项

浏览器 MCP 服务仅支持必要的配置选项：

node cli.js --help

可用选项：

• --host <host> - 服务绑定的主机（默认值：localhost；使用 0.0.0.0 可绑定到所有接口）
• --port <port> - HTTP 传输所监听的端口（Docker/服务模式）

带选项的示例：

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js",
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

HTTP 服务模式（Docker）：

适用于 Docker 或无头服务环境：

# Run as HTTP server
ANCHOR_API_KEY="sk-your-key" node cli.js --port 8931 --host 0.0.0.0

然后配置 MCP 客户端使用 HTTP 端点：

{
  "mcpServers": {
    "anchor-browser": {
      "url": "http://localhost:8931/mcp"
    }
  }
}

为什么选项这么少？

由于 Anchor Browser 在远程处理所有复杂的浏览器管理，大多数传统浏览器选项都没有必要：

• 无需选择浏览器 - Anchor 使用经过优化的远程浏览器
• 无需配置代理 - Anchor 提供内置代理轮换
• 无需管理浏览器配置文件 - 由 Anchor 的基础设施处理
• 无需网络过滤 - 使用 Anchor 控制面板进行高级控制
• 无需配置视口/设备选项 - 通过 Anchor Browser API 配置这些选项

这样可以让 MCP 服务保持简单，专注于关键任务：连接到 Anchor 的远程浏览器服务。

工作原理

1. 创建浏览器会话：使用浏览器工具时，MCP 服务会调用 Anchor API 创建远程浏览器会话
2. 远程连接：通过 Chrome DevTools Protocol（CDP）使用 WebSocket 连接到远程浏览器
3. 执行工具：所有浏览器自动化都在 Anchor 的云基础设施中进行
4. 代理与隐身：自动轮换住宅代理并使用高级反检测功能
5. 会话管理：每个会话相互隔离，并可通过 Anchor 控制面板实时查看

相较于本地浏览器的优势

🌐 全球代理网络

• 自动轮换住宅代理
• 支持不同地区的地理定位
• 无需配置代理

🛡️ 高级隐身

• 浏览器指纹保护
• 绕过反机器人检测
• 使用真实的浏览器环境

☁️ 云基础设施

• 无需依赖本地浏览器
• 浏览器版本一致
• 可扩展的执行能力

📊 监控与调试

• 实时查看浏览器会话
• 会话录制和跟踪
• 网络请求日志

可用工具

Browser MCP 服务提供所有标准的浏览器自动化工具：

核心自动化

• anchor_navigate - 导航到 URL
• anchor_click - 点击元素
• browser_type - 在输入框中输入文本
• browser_snapshot - 获取页面无障碍树
• browser_take_screenshot - 截取屏幕截图
• browser_evaluate - 执行 JavaScript
• browser_wait_for - 等待条件满足

标签页管理

• browser_tab_new - 打开新标签页
• browser_tab_list - 列出已打开的标签页
• browser_tab_select - 切换标签页
• browser_tab_close - 关闭标签页

高级功能

• browser_file_upload - 上传文件
• browser_handle_dialog - 处理警告框/确认框
• browser_network_requests - 查看网络流量
• browser_pdf_save - 生成 PDF（需使用 --caps=pdf）

故障排除

API 密钥无效

Error: Missing ANCHOR_API_KEY environment variable

解决方案：确保已在 MCP 配置中正确设置 API 密钥。

构建错误

npm run build

解决方案：确保已安装 Node.js 18+，并先运行 npm install。

连接问题

检查 MCP 日志中的 Anchor API 响应和 WebSocket 连接状态。

会话限制

每个 Anchor API 密钥都有会话限制。请在 anchorbrowser.io 查看用量。

开发

如需修改或扩展 Browser MCP 服务：

# Make changes to TypeScript files in src/
# Then rebuild
npm run build

# Test your changes
node cli.js --help

对于所有操作，服务将自动使用 Anchor 的远程浏览器，让您享受基于云的浏览器自动化的优势，以及高级代理和隐身功能。

许可证

本项目采用 Apache License 2.0 许可，详情请参阅 LICENSE 文件。

支持

• Anchor Browser：anchorbrowser.io
• 文档：Anchor Browser 文档
• MCP 协议：Model Context Protocol