io.github.Digital-Defiance/mcp-debugger

Start a new debug session with a Node.js process. The process will be paused at the start.

Set a breakpoint at a specific file and line number. Optionally provide a condition.

Resume execution of a paused debug session until the next breakpoint or program termination.

Execute the current line and pause at the next line in the same scope.

Evaluate a JavaScript expression in the current execution context and return the result with type information.

Get the current call stack with function names, file locations (absolute paths), and line numbers.

Run a command and detect if it hangs or enters an infinite loop. Returns hang status, location, and stack trace if hung.

Execute the current line and pause at the first line inside any called function.

Execute until the current function returns and pause at the calling location.

Pause a running debug session and return the current execution location.

Remove a breakpoint from the debug session.

Toggle a breakpoint between enabled and disabled states.

Get all breakpoints for a debug session with their file, line, condition, and enabled state.

Get all local variables in the current scope with their names, values, and types.

Get global variables accessible from the current scope with their names, values, and types.

Inspect an object by its object reference, returning properties with values. Handles nested objects and arrays up to a specified depth.

Add an expression to the watch list. The expression will be evaluated each time the process pauses.

Remove an expression from the watch list.

Get all watched expressions with their current values. Reports value changes since the last pause.

Switch the execution context to a specific stack frame by index. Frame 0 is the top frame (current location).

Stop a debug session, cleanup all resources, and kill the process if still running.

Set a logpoint that logs a message without pausing execution. Use {variable} syntax for interpolation.

Set an exception breakpoint to pause on caught and/or uncaught exceptions.

Set a function breakpoint to pause when a function with the given name is called.

Set a hit count condition for a breakpoint. The breakpoint will only pause when the condition is met.

Start CPU profiling for a debug session. Collects CPU profile data for performance analysis.

Stop CPU profiling and return the profile data with bottleneck analysis.

Take a heap snapshot for memory analysis. Returns memory usage report.

Get performance metrics including current memory usage, performance timeline, and leak detection.