JinDaGe - chrome-debug-mcp MCP Details

article

README

🚀 Chrome 调试指南

本指南将为你详细介绍 Chrome 调试工具的安装、使用方法，帮助你高效地进行 Chrome 调试工作。

🚀 快速开始

初始化配置

在项目根目录下创建一个 config.js 文件：

// config.js
module.exports = {
  port: 9229, // 自定义调试端口
  chromePath: 'C:/Program Files/Google/Chrome/Application/chrome.exe' // Chrome 安装路径
};

启动调试服务器

在终端中运行以下命令启动调试服务：

node index.js

✨ 主要特性

支持通过 npm 安装，方便快捷。
可手动安装，直接从 GitHub 下载源代码。
提供丰富的调试命令，满足不同调试需求。

📦 安装指南

通过 npm 安装

你可以使用 Node.js 的包管理工具 npm 来安装项目：

npm install chrome-debug

手动安装

若不想使用 npm，可直接从 GitHub 下载源代码，并解压到项目目录中。

💻 使用示例

基础用法

const { Debugger } = require('chrome-debug');

// 初始化调试器
const debugger = new Debugger({
  port: 9229, // 自定义端口
  configPath: 'config.js' // 配置文件路径
});

// 启动调试服务
debugger.start().then(() => {
  console.log('调试服务器已启动');
});

高级用法

const { chrome } = require('@modelcontextprotocol/chrome-remote-interface');

async function main() {
  const chrome = await chrome.connect({
    url: 'ws://localhost:9229',
    target: {
      browserContextId: 0
    }
  });

  // 操作示例：获取当前页面标题
  const title = await chrome.Runtime.getTitle();
  console.log('页面标题:', title);

  // 关闭 Chrome 实例
  await chrome.close();
}

main().catch(console.error);

📚 详细文档

调试命令

启动新会话

chrome-debug --start --port=9230

连接到现有会话

chrome-debug --connect --url=http://localhost:9230

项目依赖

此项目使用了以下开源库：

Puppeteer - Chrome 自动化库
Chrome DevTools Protocol - Chrome 调试工具协议客户端
@modelcontextprotocol/sdk - MCP SDK 用于服务器实现

📄 许可证

此项目遵循 MIT 协议，具体内容请参阅 LICENSE 文件。

贡献指南

有关贡献的详细信息，请参阅 Contributing.md。

致谢

感谢以下资源和社区的支持：

chrome-debug-mcp