Chrome MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过 Chrome 开发者工具协议 (CDP) 提供对 Chrome 浏览器实例的细粒度控制。

前提条件

• Bun (推荐) 或 Node.js (v14 或更高版本)
• 启用远程调试的 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 (string): 要导航到的 URL

click

在特定坐标处点击。

参数:

• x (number): X 坐标
• y (number): Y 坐标

type

在当前焦点处输入文本。

参数:

• text (string): 要输入的文本

clickElement

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

参数:

• selector (string): 元素索引 (例如，"0" 表示第一个元素)

getText

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

参数:

• selector (string): 用于查找元素的 CSS 选择器

getPageInfo

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

getPageState

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

用法

服务器使用 SSE 传输实现模型上下文协议。 连接到服务器:

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

与 Roo Code 一起使用时，MCP 设置文件中的配置将自动处理连接。

开发

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

bun dev

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

许可证

MIT