Browse Together MCP

基本能力

产品定位

Browse Together MCP 是一个浏览器自动化工具，结合 MCP 服务器，提供浏览器控制和协同浏览功能。

核心功能

• 多浏览器支持：支持 Chromium（默认）和 Firefox。
• 持久浏览器会话：单个浏览器实例在整个服务生命周期内运行。
• 命名标签页：使用唯一 ID 控制多个页面（标签页）。
• HTTP API：通过简单的 JSON 命令与浏览器交互。
• MCP 集成：通过 Cline、Windsurf、Claude Desktop 等 MCP 客户端使用浏览器功能。
• 类型安全：使用 Zod 进行命令验证。
• API 令牌安全：保护浏览器代理服务的 HTTP 端点。

适用场景

• 浏览器自动化任务
• 协同浏览（Co-browsing）
• 通过 MCP 客户端控制浏览器会话
• 获取页面内容或执行浏览器操作

工具列表

• goto：导航到 URL
• click：点击元素
• fill：填写表单字段
• content：获取页面 HTML 内容
• fetch：在浏览器上下文中执行 fetch 请求
• listPages：列出所有活动浏览器页面
• closePage：关闭特定页面

常见问题解答

• 是否支持 Computer Use / Operator？ 不支持。这是一个普通的浏览器，允许通过 HTTP API 或 MCP 客户端控制会话，但不具备 Computer Use / Operator 功能。
• 支持哪些操作系统？ 目前支持 Mac OS，但可以通过少量修改扩展到其他平台。

使用教程

使用依赖

安装 Playwright 浏览器包：

# 安装所有浏览器
npx playwright install

# 或安装特定浏览器
npx playwright install chromium
npx playwright install firefox

安装 Deno：

curl -fsSL https://deno.land/install.sh | sh

安装教程

1. 启动浏览器服务：

deno task browser

1. 配置 MCP 客户端（如 Claude Desktop）：

{
  "mcpServers": {
    "browse-together": {
      "command": "deno",
      "args": ["run", "-A", "/path/to/browse-together-mcp/mcp.ts"]
    }
  }
}

或直接启动 MCP 服务器进行测试：

deno task mcp

调试方式

选择浏览器类型：

# 通过环境变量使用 Firefox
BROWSER_TYPE=firefox deno task browser

# 或通过 CLI 标志
deno task browser --browser-type firefox

通过 HTTP API 交互示例：

# 导航到 URL
curl -X POST http://localhost:8888/api/browser/myTab \
  -H "Content-Type: application/json" \
  -d '{"action":"goto","url":"https://example.com"}'

# 点击元素
curl -X POST http://localhost:8888/api/browser/myTab \
  -H "Content-Type: application/json" \
  -d '{"action":"click","selector":"#submit-button"}'

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。