返回 MCP 目录
public公开dns本地运行

mcp-server-cloudbrowser

一个基于Browserbase API的云浏览器MCP服务,提供网页导航、脚本执行、截图等浏览器操作功能,可通过Claude Desktop集成使用。

article

README

🚀 云浏览器 MCP 服务器

云浏览器 MCP 服务器为用户提供了便捷的工具,可在浏览器中执行各类操作,如导航、执行 JavaScript 代码、截图等,能有效提升使用 Claude Desktop 时的操作效率。

🚀 快速开始

环境准备与启动

  1. 运行 npm install 安装必要的依赖项,然后运行 npm run build 生成 dist/index.js 文件。
  2. 运行 npm run inspector 启动服务器。

配置 Claude Desktop

  1. 运行 npm install 安装必要的依赖项,然后运行 npm run build 生成 dist/index.js 文件。
  2. 配置您的 Claude Desktop 设置以使用该服务器,示例配置如下:
{
  "mcpServers": {
    "cloudbrowser": {
      "command": "node",
      "args": ["path/to/mcp-server-cloudbrowser/cloudbrowser/dist/index.js"],
      "env": {
        "API_KEY": "<YOUR_BROWSERBASE_API_KEY>"
      },
      "transportType": "stdio"
    }
  }
}
  1. 重启您的 Claude Desktop 应用,您应该可以在点击 🔨 图标后看到可用工具。
  2. 开始使用这些工具! 下图展示了 Claude 关闭浏览器会话的示例。

使用 npm 配置

{
  "mcpServers": {
    "cloudbrowser": {
      "command": "cmd",
      "args": [
        "/c", 
        "npx", 
        "-y", 
        "@browsercloud/mcp-server-cloudbrowser"
      ],
      "env": {
        "API_KEY": "<YOUR_BROWSERBASE_API_KEY>"
      },
      "transportType": "stdio"
    }
  }
}

✨ 主要特性

Browserbase API

  • cloudbrowser_navigate

    • 功能:在浏览器中导航到任意 URL。
    • 输入:url (字符串)。
  • cloudbrowser_evaluate

    • 功能:在浏览器控制台执行 JavaScript。
    • 输入:script (字符串):要执行的 JavaScript 代码。
  • cloudbrowser_get_current_url

    • 功能:获取当前页面的 URL。
  • cloudbrowser_screenshot

    • 功能:捕获页面或特定元素的截图。
    • 输入:
      • name (字符串,必需):截图名称。
      • selector (字符串,可选):用于截图的 CSS 选择器。
      • width (数字,可选,默认值:800):截图宽度。
      • height (数字,可选,默认值:600):截图高度。
  • cloudbrowser_click

    • 功能:点击页面上的元素。
    • 输入:selector (字符串):要点击的元素的 CSS 选择器。
  • cloudbrowser_fill

    • 功能:填充输入字段。
    • 输入:
      • selector (字符串):输入字段的 CSS 选择器。
      • value (字符串):要填充的值。
  • cloudbrowser_get_text

    • 功能:提取当前页面的所有内容。
    • 输入:selector (字符串,可选):用于提取特定元素内容的 CSS 选择器。

资源

服务器提供了访问两种类型资源的功能:

  • 截图 (screenshot://<name>)
    • 页面的 PNG 图像,通过指定的截图名称即可访问。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端