jetbrains-debugger

Debug JetBrains IDE run configurations via MCP with breakpoints and stepping.

97|21|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/hechtcarmel/jetbrains-debugger-mcp-plugin --skill jetbrains-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jetbrains-debugger
Source: https://github.com/hechtcarmel/jetbrains-debugger-mcp-plugin/tree/main/src/main/resources/skill/jetbrains-debugger
Command: npx skills add https://github.com/hechtcarmel/jetbrains-debugger-mcp-plugin --skill jetbrains-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you debug runtime behavior in JetBrains IDEs when static code reading and guesswork can’t explain wrong values, unexpected control flow, or failing tests.

Core Features & Use Cases

  • Breakpoints and tracepoints: Set line breakpoints, conditional pauses, and log-only tracepoints to pinpoint where execution diverges.
  • Execution control and stepping: Start/stop debug sessions and drive step over/into/out or run-to-line to move through code precisely.
  • Runtime inspection and evaluation: Inspect variables/stack/source context and evaluate expressions in the current debug frame to validate hypotheses.
  • Multi-session debugging support: Manage multiple concurrent sessions and retrieve rich state in a single call.
  • Safety-aware expression handling: Works within IDE safety filters (blocklists / read-only modes) and provides guidance for safer inspection when evaluation is restricted.

Quick Start

Use the jetbrains-debugger skill to set breakpoints, start the appropriate debug configuration, wait for the pause, then inspect variables and step through execution until you find the root cause.

Frequently Asked Questions about jetbrains-debugger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug incorrect runtime behavior in JetBrains IDEs programmatically?

To debug incorrect runtime behavior in JetBrains IDEs, this skill applies programmatic breakpoint placement and step-through execution control to resolve unexpected control flow or wrong values.

Can I set conditional breakpoints and tracepoints using an MCP debugger?

Yes, you can set conditional breakpoints and tracepoints. This skill applies conditional pauses and log-only tracepoints via MCP to pinpoint where execution diverges.

How do I evaluate expressions and inspect stack frames during step-through debugging?

To evaluate expressions and inspect stack frames during step-through debugging, use the provided toolchain with coordinated wait_for_pause. It enables in-context inspection of values, source, and evaluated expressions.

Does JetBrains programmatic debugging support multiple concurrent debug sessions?

Yes, JetBrains programmatic debugging supports multiple concurrent sessions. You can manage multiple concurrent debug sessions and retrieve rich state in a single call.

What are the limitations of expression evaluation in restricted JetBrains IDE safety modes?

The limitations of expression evaluation in restricted JetBrains IDE safety modes involve blocklists and read-only modes. The skill works within IDE safety filters and provides guidance for safer inspection.