Chrome MCP Server

Chrome MCP Server

site icon
2025.03.27 12
TypeScript浏览器自动化开发工具浏览器自动化
Chrome MCP Server 是一个基于模型上下文协议(MCP)的服务,通过 Chrome DevTools 协议(CDP)提供对 Chrome 浏览器实例的精细控制。它允许开发者通过一系列工具进行浏览器自动化操作,如导航、点击、输入文本等。
View on GitHub

Overview

基本能力

产品定位

Chrome MCP Server 是一个用于浏览器自动化的服务,通过 MCP 协议实现对 Chrome 浏览器的精细控制。

核心功能

  1. 浏览器控制:通过 CDP 实现对 Chrome 浏览器的精细控制。
  2. 工具集:提供多种工具,如导航、点击、输入文本、获取元素信息等。
  3. 开发支持:支持开发模式下的热重载,便于快速迭代开发。

适用场景

  1. 自动化测试:用于自动化测试场景,模拟用户操作。
  2. 数据抓取:通过浏览器自动化进行网页数据抓取。
  3. 开发调试:在开发过程中快速调试浏览器行为。

工具列表

  1. navigate:导航到指定 URL。
  2. click:在指定坐标点击。
  3. type:在当前焦点输入文本。
  4. clickElement:通过索引点击页面元素。
  5. getText:通过 CSS 选择器获取元素文本内容。
  6. getPageInfo:获取页面的语义信息,包括交互元素和文本节点。
  7. getPageState:获取当前页面状态,包括 URL、标题、滚动位置和视口大小。

常见问题解答

  1. 如何启用远程调试:启动 Chrome 时添加 --remote-debugging-port=9222 参数。
  2. 如何配置 Roo Code:在 Roo Code 的 MCP 设置文件中添加服务器配置。

使用教程

使用依赖

  1. 安装 Bun 或 Node.js: ```bash # 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 远程调试**:bash # 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 ```

安装教程

  1. 安装依赖bash bun install
  2. 启动服务器bash bun start
  3. 开发模式(热重载)bash bun dev

调试方式

  1. 检查服务器是否运行:默认端口为 3000,可通过 PORT 环境变量更改。
  2. 连接 SSE 端点http://localhost:3000/sse
  3. 发送消息:通过 http://localhost:3000/message?sessionId=... 发送消息。

许可证

该项目遵循 MIT 开源许可条款。