Chrome MCP 服务器

这是一个通过 Chrome 开发者工具协议（CDP）对 Chrome 浏览器实例进行细粒度控制的模型上下文协议（MCP）服务器。

预备条件

• Bun（推荐）或 Node.js（版本 14 或更高）
• 启用了远程调试功能的 Chrome 浏览器

安装

安装 Bun

1. 如果尚未安装，请安装 Bun：

# macOS, Linux 或 WSL
curl -fsSL https://bun.sh/install | bash

# Windows（使用 PowerShell）
powershell -c "irm bun.sh/install.ps1 | iex"

# 或者使用 npm
npm install -g bun

2. 启动启用远程调试功能的 Chrome：

   # macOS
   /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222
   
   # Windows
   start chrome --remote-debugging-port=9222
   
   # Linux
   google-chrome --remote-debugging-port=9222
   

3. 安装依赖项：

bun install

4. 启动服务器：

bun start

对于带有热重载功能的开发模式：

bun dev

默认情况下，服务器将在端口 3000 上启动。您可以通过设置 PORT 环境变量来更改此端口。

配置 Roo Code 使用此 MCP 服务器

要将此 Chrome MCP 服务器与 Roo Code 结合使用：

1. 打开 Roo Code 设置

2. 导航到 MCP 设置配置文件的位置：

   • macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

3. 在 mcpServers 对象中添加以下配置：

{
  "mcpServers": {
    "chrome-control": {
      "url": "http://localhost:3000/sse",
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

4. 保存文件并重启 Roo Code 以应用更改。

5. 您现在可以使用 Roo Code 中的 Chrome MCP 工具来控制浏览器。

可用工具

该服务器提供了以下用于浏览器控制的工具：

navigate

导航到特定的 URL。

参数：

• url（字符串）：要导航到的 URL

click

在特定坐标处点击。

参数：

• x（数字）：X 坐标
• y（数字）：Y 坐标

type

在当前焦点处输入文本。

参数：

• text（字符串）：要输入的文本

clickElement

通过页面信息中的元素索引点击元素。

参数：

• selector（字符串）：元素索引（例如，“0”表示第一个元素）

getText

使用 CSS 选择器获取元素的文本内容。

参数：

• selector（字符串）：用于查找元素的 CSS 选择器

getPageInfo

获取页面的语义信息，包括交互元素和文本节点。

getPageState

获取当前页面状态，包括 URL、标题、滚动位置和视口大小。

使用方法

该服务器实现了使用 SSE 传输的模型上下文协议。连接到服务器的地址如下：

• SSE 终点：http://localhost:3000/sse
• 消息终点：http://localhost:3000/message?sessionId=...

当与 Roo Code 结合使用时，MCP 设置文件中的配置会自动处理连接。

开发

要在开发模式下运行服务器并启用热重载：

bun dev

这将使用 Bun 内置的监视模式，在文件更改时自动重启服务器。

许可证

MIT