⚠️ 已弃用

本仓库不再维护。 核心功能自 2025.2 版本起已集成到所有基于 IntelliJ 的 IDE 中。
内置功能支持 SSE（Server-Sent Events，服务器发送事件）和基于 JVM 的代理（用于 STDIO），因此不再需要此 NPM 包。

迁移指南： 有关如何使用内置功能的详细信息，请参阅 官方文档。

问题与支持： 如需报告内置 MCP（Model Context Protocol，模型上下文协议）功能相关的 Bug 或提出功能请求，请使用 JetBrains YouTrack。

JetBrains MCP 代理服务器

该服务器将客户端请求代理至 JetBrains IDE。

安装 MCP Server 插件

https://plugins.jetbrains.com/plugin/26071-mcp-server

VS Code 安装

如需一键安装，请点击下方任一安装按钮：

手动安装

将以下 JSON 块添加到 VS Code 的用户设置（JSON）文件中。可通过按下 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来打开该文件。

{
  "mcp": {
    "servers": {
      "jetbrains": {
        "command": "npx",
        "args": ["-y", "@jetbrains/mcp-proxy"]
      }
    }
  }
}

您也可以选择将其添加到工作区中的 .vscode/mcp.json 文件：

{
  "servers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

与 Claude Desktop 配合使用

若要在 Claude Desktop 中使用，请将以下内容添加到您的 claude_desktop_config.json 文件中。
MacOS 上的完整路径为：~/Library/Application\ Support/Claude/claude_desktop_config.json，Windows 上为：%APPDATA%/Claude/claude_desktop_config.json。

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

安装 MCP Server 插件并将上述 JSON 添加到配置文件后，请重启 Claude Desktop，并确保在重启前已打开 JetBrains 产品。

配置

如果您运行了多个启用了 MCP 服务器的 IDE，并希望连接到特定的一个，请在 MCP 服务器配置中添加：

"env": {
  "IDE_PORT": "<IDE 内置 Web 服务器的端口>"
}

默认情况下，我们会连接到 127.0.0.1 上的 IDE，但您也可以指定不同的地址/主机：

"env": {
  "HOST": "<IDE 内置 Web 服务器的主机/地址>"
}

如需启用日志记录，请添加：

"env": {
  "LOG_ENABLED": "true"
}

故障排除

Node.js 版本要求

问题： 出现错误信息：Cannot find module 'node:path'

解决方案：
MCP Proxy 不支持 Node 16。
请将您的 Node.js 升级至 18 或更高版本。确保配置中的 command 指向正确的 Node.js 版本。
建议尝试使用最新版 Node.js 的完整路径。

MacOS：插件无法检测通过 nvm 安装的 Node.js

问题： 在 MacOS 上，如果您通过 nvm（Node Version Manager）安装了 Node.js，MCP Server 插件可能无法检测到您的 Node.js 安装。

解决方案： 在 /usr/local/bin 中创建一个指向 nvm 的 npx 可执行文件的符号链接：

which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx

该命令会检查 npx 是否存在于您的路径中，并以适当的权限创建所需的符号链接。

与外部客户端或 Docker 容器配合使用（LibreChat、Cline 等）

问题： 当尝试从外部客户端、Docker 容器或第三方应用程序（如 LibreChat）连接 JetBrains MCP 代理时，对类似 http://host.docker.internal:6365/api/mcp/list_tools 的端点的请求可能会返回 404 错误或连接失败。

解决方案： 需解决两个关键问题：

1. 启用外部连接：
   在 JetBrains IDE 中，进入 Settings | Build, Execution, Deployment | Debugger，勾选 “Can accept external connections”。

2. 使用局域网 IP 和端口进行配置：
   使用您机器的局域网 IP 地址，而非 host.docker.internal；
   在配置中显式设置 IDE_PORT 和 HOST。

   以下是 LibreChat 或类似外部客户端的示例配置：

mcpServers:
  intellij:
    type: stdio
    command: sh
    args:
      - "-c"
      - "IDE_PORT=YOUR_IDEA_PORT HOST=YOUR_IDEA_LAN_IP npx -y @jetbrains/mcp-proxy"

替换：

• YOUR_IDEA_PORT 为您 IDE 的调试端口（可在 IDE 设置中找到）
• YOUR_IDEA_LAN_IP 为您计算机的本地网络 IP（例如 192.168.0.12）

如何构建

1. 已在 macOS 上测试
2. brew install node pnpm
3. 运行 pnpm build 构建项目

mcp-jetbrains 快速上手指南

⚠️ 注意：此仓库已弃用。自 IntelliJ 系列 IDE 2025.2 版本起，MCP 功能已内置，无需额外安装本工具。
如需使用，请参考 JetBrains 官方文档。

---

环境准备

• 操作系统：Windows / macOS / Linux
• Node.js：版本 ≥ 18（不支持 Node.js 16）
  • 推荐使用 nvm 或 国内镜像源 安装
• IDE 要求：IntelliJ IDEA、PyCharm 等 JetBrains IDE（2025.2 之前版本需手动安装插件）

💡 国内用户可使用以下命令加速安装：

npm config set registry https://registry.npmmirror.com

安装步骤

1. 在 JetBrains IDE 中安装插件

访问插件市场安装 MCP Server。

2. 在 VS Code 中配置 MCP 服务

方法一：一键安装（推荐）

点击以下按钮自动配置：

• VS Code
• VS Code Insiders

方法二：手动配置

按 Ctrl + Shift + P，输入 Preferences: Open User Settings (JSON)，添加：

{
  "mcp": {
    "servers": {
      "jetbrains": {
        "command": "npx",
        "args": ["-y", "@jetbrains/mcp-proxy"]
      }
    }
  }
}

或在项目根目录创建 .vscode/mcp.json 文件：

{
  "servers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

基本使用

1. 启动你的 JetBrains IDE（如 IntelliJ IDEA）
2. 在 VS Code 中打开支持 MCP 的 AI 工具（如 Cursor、Continue 等）
3. 工具将自动通过 @jetbrains/mcp-proxy 连接到 IDE，获取上下文信息（如当前文件、项目结构等）

✅ 最简验证：在 VS Code 中调用 AI 功能时，若能正确引用当前 IDE 中打开的代码文件，即表示连接成功。