Chrome 调试指南

安装指南

通过 npm 安装

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

npm install chrome-debug

手动安装

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

快速入门

初始化配置

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

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

启动调试服务器

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

node index.js

使用示例

基本用法

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

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

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

调试 Chrome 实例

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 DevTools Protocol
• Greasemonkey API
• Model Context Protocol