项目简介

Node.js 调试 MCP 服务器是一个专门为 AI 助手设计的后端服务，它通过 Model Context Protocol (MCP) 标准，将 Chrome DevTools Protocol (CDP) 的强大功能暴露为可调用的工具。这意味着 AI 助手能够以编程方式完全控制 Node.js 应用程序的调试过程，实现自动化调试、故障诊断和运行时行为分析。

主要功能点

完整的 Node.js 调试功能: 支持设置普通断点、条件断点、日志点以及配置异常暂停行为。
执行控制: 提供步过、步入、步出、继续执行到特定位置以及重新启动帧等操作。
变量与作用域检查: 能够检查局部变量、闭包作用域、'this' 上下文，并深入查看对象属性。
表达式求值: 在当前执行帧中评估 JavaScript 表达式，并捕获控制台输出。
调用栈分析: 查看当前调用栈信息和暂停状态。
源代码与脚本管理: 列出已加载脚本、获取脚本源代码、配置黑盒脚本以忽略调试。
控制台监控: 捕获并查看调试会话期间的控制台输出。

安装步骤

确保您的系统已安装 Node.js 和 npm。

打开终端或命令行，运行以下命令安装此 MCP 服务器：

npm install devtools-debugger-mcp

服务器配置

MCP 客户端需要配置该服务器的启动命令和参数才能与其建立连接。以下是推荐的 JSON 配置格式，您需要将其添加到 MCP 客户端的配置中：

{
  "devtools-debugger-mcp": {
    "command": "node", // 启动 Node.js 运行时
    "args": ["path/to/devtools-debugger-mcp/dist/index.js"] // MCP 服务器入口文件（根据实际安装路径调整）
  }
}

如果您已全局安装 'devtools-debugger-mcp' 包，也可以使用其 CLI 命令：

{
  "devtools-debugger-mcp": {
    "command": "devtools-debugger-mcp" // 全局安装后的 MCP 服务器 CLI 命令
  }
}

基本使用方法

一旦 MCP 客户端配置并连接到此服务器，AI 助手就可以通过调用以下工具来进行 Node.js 调试：

启动调试会话: 调用 'start_node_debug' 工具，提供要调试的 Node.js 脚本的绝对路径，例如： '{"tool": "start_node_debug", "params": {"scriptPath": "/absolute/path/to/app.js"}}'
设置断点: 调用 'set_breakpoint' 工具，指定文件路径和行号（1-based），例如： '{"tool": "set_breakpoint", "params": {"filePath": "/absolute/path/to/app.js", "line": 42}}'
继续执行: 调用 'resume_execution' 工具以运行到下一个断点或程序结束，可以可选地包含控制台输出和调用栈信息，例如： '{"tool": "resume_execution", "params": {"includeConsole": true, "includeStack": true}}'
检查变量: 在程序暂停时，调用 'inspect_scopes' 工具来查看局部变量和闭包，例如： '{"tool": "inspect_scopes", "params": {"maxProps": 15}}' 或者调用 'evaluate_expression' 来评估表达式，例如： '{"tool": "evaluate_expression", "params": {"expr": "user.name"}}'
单步调试: 根据需要调用 'step_over'（步过）、'step_into'（步入）或 'step_out'（步出）工具，例如： '{"tool": "step_over"}'
结束调试: 调用 'stop_debug_session' 工具来终止当前的调试会话并清理资源，例如： '{"tool": "stop_debug_session"}'

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息