Chrome MCP Server

Chrome MCP Server

site icon
2025.03.10 2
JavaScript调试工具监控工具开发辅助浏览器自动化开发效率
Chrome MCP Server 是一个 Node.js 服务器,与 Chrome DevTools 扩展集成,为 Cursor AI 提供调试和监控功能。它充当 Chrome DevTools 扩展和 Cursor AI 之间的桥梁,支持捕获控制台日志和错误、监控网络请求、截图、检查选定元素以及清除日志等功能。
View on GitHub

Overview

基本能力

产品定位

Chrome MCP Server 是一个调试和监控工具,专为开发人员设计,用于在开发过程中捕获和分析浏览器行为。

核心功能

  • 捕获控制台日志
  • 捕获控制台错误
  • 监控网络请求(成功和失败)
  • 截图功能
  • 检查选定元素
  • 清除日志

适用场景

  • 前端开发调试
  • 自动化测试
  • 性能监控
  • 错误追踪

工具列表

  • getConsoleLogs: 获取控制台日志
  • getConsoleErrors: 获取控制台错误
  • getNetworkErrorLogs: 获取网络错误日志
  • getNetworkSuccessLogs: 获取网络成功日志
  • takeScreenshot: 截取页面截图
  • getSelectedElement: 获取选定元素信息
  • wipeLogs: 清除所有存储的日志

常见问题解答

  1. JSON解析错误:确保使用v1.2.0或更高版本
  2. 端口占用错误:服务器会自动尝试备用端口
  3. Windows构建错误:最新版本已支持Windows构建
  4. ES模块错误:确保使用最新版本支持ES6模块

使用教程

使用依赖

  • Node.js 14+
  • Chrome 88+
  • 支持MCP的Cursor

安装教程

直接从GitHub运行

# Windows
cmd /c npx github:adejaimejr/chrome-mcp-server

# Linux/Mac
npx github:adejaimejr/chrome-mcp-server

全局安装

# 全局安装
npm install -g github:adejaimejr/chrome-mcp-server

# 运行
chrome-mcp-server

本地安装

# 1. 克隆仓库
git clone https://github.com/adejaimejr/chrome-mcp-server.git

# 2. 进入目录
cd chrome-mcp-server

# 3. 安装依赖
npm install

# 4. 构建可执行文件
npm run build

# 5. 使用绝对路径运行
# Windows示例:
node C:\路径\到\chrome-mcp-server\dist\mcp-server.js

# Linux/Mac示例:
node /路径/到/chrome-mcp-server/dist/mcp-server.js

调试方式

  1. 在Cursor中配置MCP服务器
  2. 使用提供的工具获取调试信息
  3. 检查日志和错误信息
  4. 使用截图功能验证页面状态

版本特性

  • v1.2.0: 强制JSON输出格式,自动端口处理,Windows构建支持

许可证

None