Debugger MCP Server

A JetBrains IDE plugin that exposes an MCP (Model Context Protocol) server, giving AI coding assistants full programmatic control over the debugger. Set breakpoints, step through code, inspect variables, and evaluate expressions—all driven autonomously by your AI assistant.

Fully tested: IntelliJ IDEA, PyCharm, WebStorm, GoLand, RustRover, Android Studio, PhpStorm May work (untested): RubyMine, CLion, DataGrip

Debugger MCP Server gives AI coding assistants complete control over the IDE's debugger through the Model Context Protocol (MCP). Let your AI assistant debug code autonomously—from setting breakpoints to inspecting variables to stepping through execution.

Features

Debug Session Management

Start/Stop Sessions - Launch any run configuration in debug mode
Rich Status - Get comprehensive state in a single call (variables, stack, source context)
Multi-Session Support - Manage multiple concurrent debug sessions

Breakpoint Management

Line Breakpoints - Set breakpoints at any valid location
Conditional Breakpoints - Add conditions that must be true to pause
Tracepoints - Log messages without pausing execution

Execution Control

Step Over/Into/Out - Navigate through code line by line
Resume & Pause - Control execution flow
Run to Line - Continue execution until a specific line

Variable Inspection

View Variables - Inspect local variables, arguments, and object fields
Modify Values - Change variable values during debugging

Expression Evaluation

Evaluate Expressions - Run arbitrary expressions in the current context
Code Fragments - Execute multi-line code snippets
Safety Controls - Choose unrestricted evaluation, a default risky-operation blocklist, or conservative read-only checks with optional custom regex block rules

Stack & Thread Navigation

Stack Traces - View the complete call stack with source locations
Frame Selection - Switch context to any stack frame
Thread Listing - See all threads and their states

Companion Skill

AI Debugging Guidance - Bundled companion skill teaches AI agents optimal debugger tool usage
One-Click Install - Install to .claude/skills/ or export as .skill/.zip

Why Use This Plugin?

Unlike manual debugging, this plugin enables:

Autonomous AI Debugging - Your AI assistant can debug code without human intervention
Rich Context in Single Calls - Get variables, stack, and source in one request
Programmatic Breakpoint Control - Set conditional breakpoints with complex expressions
Cross-IDE Compatibility - Works with any JetBrains IDE that supports XDebugger
22 Comprehensive Tools - Full debugging capability through MCP
Configurable Server - IDE-specific ports with customizable host binding

Perfect for AI-assisted development workflows where you want your assistant to investigate bugs, validate fixes, or explore code behavior autonomously.

Installation
Quick Start
Client Configuration
Available Tools
Multi-Project Support
Tool Window
Error Codes
Settings
Requirements
Contributing

Installation

Using the IDE built-in plugin system

<kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>Marketplace</kbd> > <kbd>Search for "Debugger MCP Server"</kbd> > <kbd>Install</kbd>

Using JetBrains Marketplace

Go to JetBrains Marketplace and install it by clicking the <kbd>Install to ...</kbd> button.

Manual Installation

Download the latest release and install it manually: <kbd>Settings/Preferences</kbd> > <kbd>Plugins</kbd> > <kbd>⚙️</kbd> > <kbd>Install plugin from disk...</kbd>

Quick Start

Install the plugin and restart your JetBrains IDE
Open a project - the MCP server starts automatically on an IDE-specific port
Find your IDE port: <kbd>Settings</kbd> > <kbd>Tools</kbd> > <kbd>Debugger MCP Server</kbd> (each IDE has a unique default port, e.g., 29190 for IntelliJ IDEA)
Configure your AI assistant with the server URL: http://127.0.0.1:{PORT}/debugger-mcp/streamable-http
Use the tool window (bottom panel: "Debugger MCP Server") to copy configuration or monitor commands

Using the "Install on Coding Agents" Button

The easiest way to configure your AI assistant:

Open the "Debugger MCP Server" tool window (bottom panel)
Click the prominent "Install on Coding Agents" button on the right side of the toolbar
A popup appears with three sections:
- Install Now - For Claude Code CLI and Codex CLI: Runs the installation command automatically
- Copy Configuration - For other clients (Gemini CLI, Cursor, etc.): Copies the JSON config to your clipboard
- Generic MCP Config - Streamable HTTP or Legacy SSE configuration for any MCP client
For "Copy Configuration" clients, paste the config into the appropriate config file

Example Workflow

Just tell your AI assistant:

"Debug the calculateTotal function—set a breakpoint at line 42, run the tests in debug mode, and show me the variable values when it pauses."

Or for more complex debugging:

"There's a bug in UserService. Set a breakpoint at line 42, run the tests in debug mode, and when it breaks, show me the stack trace and all local variables."

Client Configuration

Claude Code (CLI)

The easiest way is to use the "Install on Coding Agents" button in the IDE's tool window—it generates the correct command with your IDE-specific server name and port.

Or run this command manually in your terminal (replace <ide>-debugger and port with your IDE's values):

claude mcp add --transport http intellij-debugger http://127.0.0.1:29190/debugger-mcp/streamable-http --scope user

IDE-specific server names and default ports:

IDE	Server Name	Default Port
IntelliJ IDEA	`intellij-debugger`	29190
Android Studio	`android-studio-debugger`	29191
PyCharm	`pycharm-debugger`	29192
WebStorm	`webstorm-debugger`	29193
GoLand	`goland-debugger`	29194
PhpStorm	`phpstorm-debugger`	29195
RubyMine	`rubymine-debugger`	29196
CLion	`clion-debugger`	29197
RustRover	`rustrover-debugger`	29198
DataGrip	`datagrip-debugger`	29199
Aqua	`aqua-debugger`	29200
DataSpell	`dataspell-debugger`	29201
Rider	`rider-debugger`	29202

Options:

--scope user - Adds globally for all projects
--scope project - Adds to current project only

To remove: claude mcp remove intellij-debugger (use your IDE's name)

Codex CLI

The easiest way is to use the "Install on Coding Agents" button in the IDE's tool window—it generates the correct command with your IDE-specific server name and port.

Or run this command manually in your terminal (replace <ide>-debugger and port with your IDE's values):

codex mcp add intellij-debugger --url http://127.0.0.1:29190/debugger-mcp/streamable-http

To remove: codex mcp remove intellij-debugger (use your IDE's name)

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "intellij-debugger": {
      "httpUrl": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "intellij-debugger": {
      "url": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "intellij-debugger": {
      "serverUrl": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
    }
  }
}

VS Code (Generic MCP)

{
  "mcp.servers": {
    "intellij-debugger": {
      "url": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
    }
  }
}

Note: Replace intellij-debugger and the port with your IDE's server name and default port (see table above).

Note: The port can be changed in <kbd>Settings</kbd> > <kbd>Tools</kbd> > <kbd>Debugger MCP Server</kbd>.

Available Tools

The plugin provides 22 MCP tools organized by category:

Run Configuration Tools

Tool	Description
`list_run_configurations`	List all available run configurations in the project
`execute_run_configuration`	Execute a run configuration in debug or run mode

Debug Session Tools

Tool	Description
`list_debug_sessions`	List all active debug sessions with state and metadata
`start_debug_session`	Start a new debug session for a run configuration
`stop_debug_session`	Stop/terminate a debug session
`get_debug_session_status`	Get comprehensive status (variables, stack, source) in one call

Breakpoint Tools

Tool	Description
`list_breakpoints`	List all breakpoints with optional filtering
`set_breakpoint`	Set a line breakpoint with condition, log message, suspend policy
`remove_breakpoint`	Remove a breakpoint by ID or location

Execution Control Tools

Tool	Description
`resume_execution`	Resume paused execution
`pause_execution`	Pause running execution
`step_over`	Step over to next line (without entering methods)
`step_into`	Step into method calls
`step_out`	Step out of current method
`run_to_line`	Continue execution until a specific line

Stack & Thread Tools

Tool	Description
`get_stack_trace`	Get current call stack with file/line/method info
`select_stack_frame`	Change debugger context to a different stack frame
`list_threads`	List all threads with state information

Variable Tools

Tool	Description
`get_variables`	Get all variables visible in current stack frame
`set_variable`	Modify a variable's value during debugging

Navigation Tools

Tool	Description
`get_source_context`	Get source code around current execution point

Evaluation Tools

Tool	Description
`evaluate_expression`	Evaluate an expression or code fragment in debug context

Note: For detailed tool documentation with parameters, examples, and response formats, see USAGE.md.

Multi-Project Support

When multiple projects are open in a single IDE window, you must specify which project to use with the project_path parameter:

{
  "name": "set_breakpoint",
  "arguments": {
    "project_path": "/Users/dev/myproject",
    "file_path": "/Users/dev/myproject/src/Main.java",
    "line": 42
  }
}

If project_path is omitted:

Single project open: That project is used automatically
Multiple projects open: An error is returned with the list of available projects

Tool Window

The plugin adds a "Debugger MCP Server" tool window (bottom panel) that shows:

Server Status: Running indicator with server URL and port
**A

…

Jetbrains Debugger Mcp Plugin

Installation

Configuration

How to use

README

Debugger MCP Server

Features

Why Use This Plugin?

Table of Contents

Installation

Using the IDE built-in plugin system

Using JetBrains Marketplace

Manual Installation

Quick Start

Using the "Install on Coding Agents" Button

Example Workflow

Client Configuration

Claude Code (CLI)

Codex CLI

Gemini CLI

Cursor

Windsurf

VS Code (Generic MCP)

Available Tools

Run Configuration Tools

Debug Session Tools

Breakpoint Tools

Execution Control Tools

Stack & Thread Tools

Variable Tools

Navigation Tools

Evaluation Tools

Multi-Project Support

Tool Window

You might also like