Jetbrains Debugger MCP Plugin

MCP开发工具

提供方 hechtcarmel

开发工具 未标注 会话登录 社区 / 第三方 ClaudeCursorWindsurf

一个JetBrains IDE插件,通过MCP协议让AI编程助手能够完全控制调试器,实现断点设置、代码步进、变量检查等功能。

一句话选型结论

按资料字段整理

Jetbrains Debugger MCP Plugin 属于开发工具类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude、Cursor、Windsurf,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 72 仓库热度,无公开仓库时显示未标注
工具数 22 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量22暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Kotlin本地部署AI调试编程辅助IDE插件自动化调试变量检查

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 22 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 22 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude、Cursor、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Jetbrains Debugger MCP Plugin当前 22 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方hechtcarmel上游标注的维护方 hechtcarmel
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.3 KB
来自项目仓库与上游目录的原文,未做删改

调试器MCP服务器

一个JetBrains IDE插件,它公开了一个 MCP(模型上下文协议)服务器,为AI编码助手提供对调试器的完全编程控制。设置断点、遍历代码、检查变量和计算表达式——所有这些都由您的AI助手自主驱动。

经过全面测试:IntelliJ IDEA、PyCharm、WebStorm、GoLand、RustRover、安卓工作室、PhpStorm
可能有效 (未经测试):RubyMine、CLion、DataGraph

调试器MCP服务器 通过模型上下文协议(MCP),AI编码助手可以完全控制IDE的调试器。让你的AI助手自主调试代码——从设置断点到检查变量,再到逐步执行。

特性

调试会话管理

  • 启动/停止会话 -在调试模式下启动任何运行配置
  • 富裕状态 -在一次调用中获取全面的状态(变量、堆栈、源上下文)
  • 多会话支持 -管理多个并发调试会话

断点管理

  • 线路断点 -在任何有效位置设置断点
  • 条件断点 -添加必须为真才能暂停的条件
  • 追踪点 -在不暂停执行的情况下记录消息

执行控制

  • 跨过/进入/退出 -逐行浏览代码
  • 恢复和暂停 -控制执行流程
  • 跑向终点线 -继续执行,直到出现特定行

计量检验

  • 查看变量 -检查局部变量、参数和对象字段
  • 修改值 -在调试过程中更改变量值

表达式求值

  • 计算表达式 -在当前上下文中运行任意表达式
  • 代码片段 -执行多行代码片段

堆栈和线程导航

  • 堆栈跟踪 -查看包含源位置的完整调用堆栈
  • 显示所选帧 -将上下文切换到任何堆栈帧
  • 线程列表 -查看所有线程及其状态

同伴技能

  • AI调试指南 -捆绑的同伴技能教会AI代理最佳的调试器工具使用
  • 一键安装 -安装到 .claude/skills/ 或出口为 .skill/.zip

为什么要使用这个插件?

与手动调试不同,此插件支持:

  • 自主AI调试 -您的AI助手可以在没有人为干预的情况下调试代码
  • 单次通话中的丰富上下文 -在一个请求中获取变量、堆栈和源代码
  • 程序化断点控制 -使用复杂表达式设置条件断点
  • 跨IDE兼容性 -适用于任何支持XDebugger的JetBrains IDE
  • 22个综合工具 -通过MCP实现完全调试能力
  • 可配置服务器 -具有可定制主机绑定的IDE特定端口

非常适合人工智能辅助开发工作流程,您希望助手自主调查错误、验证修复或探索代码行为。

目录

  • 安装
  • 快速开始
  • 客户端配置
  • 可用工具
  • 多项目支持
  • 工具窗口
  • 错误代码
  • 设置
  • 需求
  • 贡献

安装

使用IDE内置插件系统

设置/首选项 > 插件 > 市场 > 搜索“调试器MCP服务器” > 安装

使用JetBrains市场

首选 JetBrains市场 并通过单击安装 安装到。.. 按钮。

手动安装

下载 最新版本 并手动安装:
设置/首选项 > 插件 > ⚙️ > 从磁盘安装插件。..

快速开始

  1. 安装插件 并重新启动JetBrains IDE
  2. 打开项目 -MCP服务器在IDE特定端口上自动启动
  3. 查找您的IDE端口: 设置 > 工具 > 调试器MCP服务器 (每个IDE都有一个唯一的默认端口,例如IntelliJ IDEA的29190)
  4. 配置您的AI助手 使用服务器URL: http://127.0.0.1:{PORT}/debugger-mcp/streamable-http
  5. 使用工具窗口 (底部面板:“调试器MCP服务器”)用于复制配置或监视命令

使用“在编码代理上安装”按钮

配置AI助手的最简单方法:

  1. 打开“调试器MCP服务器”工具窗口(底部面板)
  2. 点击突出的 “在编码代理上安装” 工具栏右侧的按钮
  3. 出现一个包含三个部分的弹出窗口:
    - 立即安装 -对于Claude Code CLI和Codex CLI:自动运行安装命令
    - 复制配置 -对于其他客户端(Gemini CLI、Cursor等):将JSON配置复制到剪贴板
    - 通用MCP配置 -任何MCP客户端的可流式HTTP或传统SSE配置
  4. 对于“复制配置”客户端,将配置粘贴到相应的配置文件中

工作流示例

告诉你的AI助手:

> 调试calculateTotal函数——在第42行设置断点,在调试模式下运行测试,并在暂停时显示变量值

或者对于更复杂的调试:

> UserService中有一个错误。在第42行设置一个断点,在调试模式下运行测试,当它中断时,向我显示堆栈跟踪和所有局部变量

客户端配置

克劳德代码(CLI)

最简单的方法是使用 “在编码代理上安装” IDE工具窗口中的按钮——它使用IDE特定的服务器名称和端口生成正确的命令。

或者在终端中手动运行此命令(替换 -debugger 并使用IDE的值进行移植):```bash
claude mcp add --transport http intellij-debugger http://127.0.0.1:29190/debugger-mcp/streamable-http --scope user


**IDE特定的服务器名称和默认端口:**

|IDE|服务器名称|默认端口|
|-----|-------------|-------------|
|IntelliJ IDEA| `intellij-debugger` | 29190 |
|安卓工作室| `android-studio-debugger` | 29191 |
|PyCharm| `pycharm-debugger` | 29192 |
|WebStorm| `webstorm-debugger` | 29193 |
|GoLand| `goland-debugger` | 29194 |
|暴风雪| `phpstorm-debugger` | 29195 |
|RubyMine| `rubymine-debugger` | 29196 |
|CLion| `clion-debugger` | 29197 |
|RustRover| `rustrover-debugger` | 29198 |
|数据夹| `datagrip-debugger` | 29199 |
|Aqua| `aqua-debugger` | 29200 |
| DataSpell | `dataspell-debugger` | 29201 |
|骑手| `rider-debugger` | 29202 |

选项:

- `--scope user` -为所有项目添加全局
- `--scope project` -仅添加到当前项目

要删除: `claude mcp remove intellij-debugger` (使用IDE的名称)

### Codex 命令行界面

最简单的方法是使用 **“在编码代理上安装”** IDE工具窗口中的按钮——它使用IDE特定的服务器名称和端口生成正确的命令。

或者在终端中手动运行此命令(替换 `-debugger` 并使用IDE的值进行移植):```bash
codex mcp add intellij-debugger --url http://127.0.0.1:29190/debugger-mcp/streamable-http

要删除: codex mcp remove intellij-debugger (使用IDE的名称)

双子星命令行工具

添加 ~/.gemini/settings.json:```json
{
"mcpServers": {
"intellij-debugger": {
"httpUrl": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
}
}
}


### 光标

添加 `.cursor/mcp.json` 在您的项目根目录中或 `~/.cursor/mcp.json` 全球地:```json
{
"mcpServers": {
"intellij-debugger": {
"url": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
}
}
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:```json
{
"mcpServers": {
"intellij-debugger": {
"serverUrl": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
}
}
}


### VS代码(通用MCP)```json
{
"mcp.servers": {
"intellij-debugger": {
"url": "http://127.0.0.1:29190/debugger-mcp/streamable-http"
}
}
}

> 备注:替换 intellij-debugger 以及带有IDE服务器名称和默认端口的端口(见上表)。

> 备注:端口可以在中更改 设置 > 工具 > 调试器MCP服务器.

可用工具

该插件提供 22个MCP工具 按类别组织:

运行配置工具

工具 说明
list_run_configurations 列出项目中所有可用的运行配置
execute_run_configuration 在调试或运行模式下执行运行配置

调试会话工具

工具 说明
list_debug_sessions 列出所有活动的调试会话及其状态和元数据
start_debug_session 为运行配置启动新的调试会话
stop_debug_session 停止/终止调试会话
get_debug_session_status 在一次调用中获取全面的状态(变量、堆栈、源代码)

断点工具

工具 说明
list_breakpoints 列出所有具有可选过滤功能的断点
set_breakpoint 使用条件、日志消息、挂起策略设置行断点
remove_breakpoint 按ID或位置删除断点

执行控制工具

工具 说明
resume_execution 恢复暂停的执行
pause_execution 暂停运行执行
step_over 跳到下一行(不输入方法)
step_into 进入方法调用
step_out 退出当前方法
run_to_line 继续执行,直到出现特定行

堆栈和线程工具

工具 说明
get_stack_trace 使用文件/行/方法信息获取当前调用堆栈
select_stack_frame 将调试器上下文更改为其他堆栈帧
list_threads 列出所有具有状态信息的线程

可变工具

工具 说明
get_variables 获取当前堆栈帧中可见的所有变量
set_variable 在调试过程中修改变量的值

导航工具

工具 说明
get_source_context 获取当前执行点附近的源代码

评价工具

工具 说明
evaluate_expression 在调试上下文中计算表达式或代码片段

> 备注:有关包含参数、示例和响应格式的详细工具文档,请参阅 用法.md.

多项目支持

当在单个IDE窗口中打开多个项目时,您必须指定要与哪个项目一起使用 project_path 参数:```json
{
"name": "set_breakpoint",
"arguments": {
"project_path": "/Users/dev/myproject",
"file_path": "/Users/dev/myproject/src/Main.java",
"line": 42
}
}


如果 `project_path` 省略:

- **单个项目打开**:该项目将自动使用
- **多个项目打开**:返回可用项目列表时出错

## 工具窗口

该插件添加了一个“调试器MCP服务器”工具窗口(底部面板),显示:

- **服务器状态**:带有服务器URL和端口的运行指示器
- **代理规则提示**:为AI代理的配置复制一条规则,以选择调试器MCP工具
- **项目名称**:当前正在进行的项目
- **命令历史记录**:所有MCP工具调用的日志,包括:
- 时间戳
- 工具名称
- 状态(成功/错误/待定)
- 参数和结果(可扩展)
- 执行持续时间
- **过滤器**:按工具名称、状态或搜索文本筛选历史记录

### 工具窗口操作

|动作|描述|
|--------|-------------|
|刷新|刷新服务器状态和命令历史记录|
|复制URL |将MCP服务器URL复制到剪贴板|
|清除历史记录|清除命令历史记录|
|导出历史记录|将历史记录导出到JSON文件|
|更改端口|打开设置以配置服务器端口和主机|
|星/报告问题|链接到GitHub存储库|
|尝试IDE索引MCP服务器|链接到配套插件|
|给我买杯咖啡|支持开发者|
| **获得陪伴技能** |安装或导出配套的AI技能,以增强调试指导|
| **在编码代理上安装** |在AI助手上安装MCP服务器(右侧突出按钮)|

## 错误代码

### JSON-RPC标准错误

|代码|名称|描述|
|------|------|-------------|
|-32700|分析错误|无法解析JSON-RPC请求|
|-32600|无效请求|JSON-RPC请求格式无效|
|-32601|找不到方法|未知方法名称|
|-32602|参数无效|参数无效或缺失|
|-32603|内部错误|意外内部错误|

### 自定义MCP错误

|代码|名称|描述|
|------|------|-------------|
|-32001|未找到会话|未找到调试会话|
|-32002|找不到文件|指定的文件不存在|
|-32003|未暂停|操作需要暂停会话|
|-32004|断点错误|设置/删除断点失败|
|-32005|计算错误|表达式计算失败|

## 设置

在以下位置配置插件 设置 > 工具 > 调试器MCP服务器:

|设置|默认值|说明|
|---------|---------|-------------|
|服务器主机|127.0.0.1|MCP服务器的绑定地址。使用 `127.0.0.1` 仅适用于本地主机, `0.0.0.0` 对于所有接口,或自定义IP|
|服务器端口|特定于IDE |每个IDE都有一个唯一的默认端口(例如,IntelliJ为29190,PyCharm为29192)。范围:1024-65535|
|最大历史记录大小|1000|历史记录中要保留的最大命令数|

## 需求

- **JetBrains集成开发环境** 2025.1或更高版本(基于IntelliJ平台的任何IDE)
- **虚拟机** 21或以后
- **MCP协议** 2025-03-26(流式HTTP,主要)和2024-11-05(SSE,传统)回退

### 支持的IDE

**经过全面测试**:IntelliJ IDEA、PyCharm、WebStorm、GoLand、RustRover、安卓工作室、PhpStorm
**可能有效** (未经测试):RubyMine、CLion、DataChip、Aqua、DataPell、Rider

## 建筑

该插件在IDE特定端口上运行嵌入式Ktor CIO服务器,并支持 **三个MCP传输**:

### 流式HTTP传输(主,MCP 2025-03-26)```
AI Assistant ──────► POST /debugger-mcp/streamable-http   (JSON-RPC with Mcp-Session-Id header)
◄── JSON-RPC response                (immediate HTTP response)
──────► DELETE /debugger-mcp/streamable-http  (session termination)

传统苏格兰和南方能源运输(MCP 2024-11-05)```

AI Assistant ──────► GET /debugger-mcp/sse (establish SSE stream)
◄── event: endpoint (receive POST URL with sessionId)
──────► POST /debugger-mcp?sessionId=x (JSON-RPC requests)
◄── HTTP 202 Accepted
◄── event: message (JSON-RPC response via SSE)


### 无状态HTTP(方便)```
AI Assistant ──────► POST /debugger-mcp              (JSON-RPC requests, no session)
◄── JSON-RPC response           (immediate HTTP response)

这种方法:

  • 现代客户 -符合MCP 2025-03-26规范的流式HTTP会话管理
  • 传统客户 -根据MCP 2024-11-05规范进行完整的SSE传输
  • 简单的客户端 -无状态HTTP,无需会话即可快速请求/响应
  • 每个IDE都有一个唯一的默认端口,以避免多个IDE同时运行时发生冲突
  • 适用于任何MCP兼容客户端
  • 支持基于浏览器的客户端的CORS

贡献

欢迎投稿!拜托:

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 运行测试: ./gradlew test
  5. 提交拉取请求

开发环境```bash

Build the plugin

./gradlew build

Run IDE with plugin installed

./gradlew runIde

Run tests

./gradlew test

Run plugin verification

./gradlew runPluginVerifier
```

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。


基于插件 IntelliJ平台插件模板.

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Jetbrains Debugger MCP Plugin 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Jetbrains Debugger MCP Plugin 怎么在 Claude、Cursor、Windsurf 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Jetbrains Debugger MCP Plugin 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Jetbrains Debugger MCP Plugin 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Jetbrains Debugger MCP Plugin 支持哪些客户端?

资料标注支持 Claude、Cursor、Windsurf;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Jetbrains Debugger MCP Plugin 能提供哪些能力?

资料显示约 22 个工具;能力标签包括 Kotlin、编程辅助、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。