/ 目录 / 演练场 / JetBrains IDEs
● 官方 JetBrains ⚡ 即开即用

JetBrains IDEs

作者 JetBrains · JetBrains/mcp-jetbrains

让你的 agent 拥有和 IntelliJ 一样的代码智能——重构、查找用法、代码检查、运行配置。

JetBrains 官方 MCP 代理。与你 IDE 中安装的 MCP Server 插件配合使用(IntelliJ、PyCharm、WebStorm、Rider 等)。agent 通过 IDE 的索引模型来查看项目结构——而不仅仅是文件系统——因此重构、查找用法和代码检查都能正常工作。

为什么要用

核心特性

实时演示

实际使用效果

jetbrains.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "jetbrains",
      "command": "npx",
      "args": [
        "-y",
        "@jetbrains/mcp-proxy"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "jetbrains": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@jetbrains/mcp-proxy"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add jetbrains -- npx -y @jetbrains/mcp-proxy

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: JetBrains IDEs

在整个项目中安全地重命名符号

👤 Java / Kotlin / Python / C# 工程师 ⏱ ~10 min intermediate

何时使用: 你想重命名一个符号,但 grep-and-replace 可能会遗漏字符串引用或动态调用。

前置条件
  • IDE 中安装了 MCP Server 插件 — plugins.jetbrains.com/plugin/26071-mcp-server——或如果在 2025.2+ 版本则内置
  • 在 IDE 中打开并索引了项目 — 打开项目;等待索引完成(查看状态栏)
步骤
  1. 查找符号
    在项目中查找 getCurrentUser 的定义和所有用法。包括测试文件。✓ 已复制
    → IDE 精确的用法列表,包含 file:line
  2. 试运行重命名
    告诉我重命名为 getAuthenticatedUser 会改变什么。标记出任何需要我手动修复的字符串字面量或基于反射的调用。✓ 已复制
    → 预览 diff + 需手动修复的列表
  3. 应用重构
    应用重命名。然后运行受影响的测试。✓ 已复制
    → 重构完成,测试通过

结果: 一个安全的重命名,具有 IDE 级别的精确度,由 IDE 的现有重构引擎支持。

注意事项
  • 基于反射或字符串构建的引用没有被捕获 — 重构后,grep 搜索旧名称作为字符串——IDE 会警告但不会自动修复这些
  • IDE 没有完全索引,结果不完整 — 运行前等待进度条清空;先询问 IDE 的索引状态
搭配使用: git

运行特定测试并迭代修复失败

👤 任何使用 JetBrains IDE 的工程师 ⏱ ~15 min intermediate

何时使用: 你希望 agent 编写代码、运行相应的测试、修复失败并迭代——不离开聊天。

前置条件
  • IDE 中存在测试的运行配置 — 右键单击测试文件 → Run——IDE 保存配置
步骤
  1. 运行特定测试
    运行 CartCalculatorTest 类。返回每个方法的通过/失败状态及失败消息。✓ 已复制
    → 结构化的测试结果
  2. 修复失败
    对于每个失败的测试,读取源码、识别 bug、提出最小化的修复。✓ 已复制
    → File:line + 提议的更改
  3. 循环
    应用修复并重新运行直到通过。不要修改测试,只修改生产代码。✓ 已复制
    → 所有测试通过

结果: 以 agent 的速度进行 TDD,利用 IDE 的编译 + 运行基础设施。

注意事项
  • Agent 修改测试来使其通过 — 显式提示:'不要修改测试文件';提交前审查 diff

通过 IDE 导航快速上手陌生的代码库

👤 新员工、代码审查者 ⏱ ~30 min beginner

何时使用: 你需要理解 X 如何被使用,而不需要手动跳转 20 个文件。

步骤
  1. 从入口点开始
    找到 POST /checkout 的 HTTP 处理器。给我展示调用链——它调用什么,深度 3。✓ 已复制
    → 包含 file:line 节点的调用树
  2. 查找测试
    找到所有测试结算流程的测试。打开每一个并总结它们覆盖了什么。✓ 已复制
    → 测试覆盖率图
  3. 解释流程
    写一个单页解释器:endpoint → 验证 → 支付 → 持久化 → 响应。用行号引用文件。✓ 已复制
    → 上手级别的解释器

结果: 在 30 分钟内建立对一个子系统的具体心智模型,而不是一整天。

注意事项
  • Agent 虚构不存在的类/方法名称 — 每个声明都必须链接到 file:line——如果不能,就是幻觉;指出来并重新查询
搭配使用: git

组合

与其他 MCP 搭配,撬动十倍杠杆

jetbrains + git

IDE 级别的重构 + 验证提交是否干净

fetchUser 重命名为 loadUser。然后给我展示 git diff——确认测试仍然通过并提交。✓ 已复制
jetbrains + github

用 IDE 导航而不是 GitHub web UI 来审查 PR

检出 PR #234 的分支。使用 find_usages 遍历 diff,理解每个修改的方法被何处调用。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
get_project_structure 在开始新项目时查看概览 free
find_usages symbol 更改前的影响分析 free
search_in_files text, scope? 在整个项目中进行全文搜索 free
get_symbol_info symbol or file:line 解析某个东西是什么 free
run_configuration config_name 执行已保存的运行配置(测试、应用、脚本) free (local)
apply_refactoring refactor type + params 重命名、提取方法、内联、移动 free
get_diagnostics file_path? 捕获 IDE 已知的问题 free

成本与限制

运行它的成本

API 配额
无——本地 IDE
每次调用 Token 数
调用链可能很大;需要显式限制深度
费用
免费——MCP 是免费的;你需要 JetBrains 许可证
提示
依赖 IDE 操作(find_usages、refactor)而不是原始文件系统读取——token 更便宜且更准确

安全

权限、密钥、影响范围

凭据存储: 无——本地 IDE
数据出站: 不向 JetBrains 发送;MCP 仅在 IDE 和客户端之间进行 localhost 通信

故障排查

常见错误与修复

连接被拒绝 / MCP 无法连接到 IDE

IDE 必须打开并启用插件。检查 Settings → Tools → MCP Server;端口通常是 63342 或自动分配。

验证: curl http://localhost:63342/api/mcp
工具返回 'Project not found'

IDE 中没有打开项目,或打开了多个项目且 agent 询问的是错误的项目。聚焦到正确的窗口。

重构报告文件已更改但看起来相同

IDE 缓冲区还没有保存到磁盘。调用 'save all' 工具或在 IDE 中按 Cmd+S。

find_usages 遗漏了引用

索引还未完成。等待 IDE 状态栏显示 'Indexing complete'。

替代方案

JetBrains IDEs 对比其他方案

替代方案何时用它替代权衡
VSCode MCP(各种社区)你使用 VSCode 而不是 JetBrains不同的 IDE、不同的生态——不是直接的替代
language-server MCPs你想通过 LSP 获得与 IDE 无关的代码智能LSP 提供基本的符号信息,但不提供重构或运行配置

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills