安装
npx -y @jetbrains/mcp-proxy适合谁
适合还在用旧版 JetBrains IDE、需要把 MCP 客户端请求代理到 IDE 的人。证据写明:这台服务器把客户端请求代理到 JetBrains IDE。
但本仓库已不再维护。核心能力从 2025.2 起已集成进所有基于 IntelliJ 的 IDE:内置支持 SSE,以及用于 STDIO 的 JVM 代理,因此这个 NPM 包不再需要。若你的 IDE 已经是 2025.2 或更新,不要装这个包。
只有在你明确仍要走历史 NPM 路径时,才继续往下。你还需要安装 MCP Server 插件,Node.js 必须是 18 或更高。证据没有列出客户端产品名单,只覆盖到「JetBrains IDE」。
3 分钟完成第一次尝试
若 IDE ≥ 2025.2:主路径是 IDE 内置 MCP(SSE / JVM STDIO 代理),到此即可,不要执行下面的 npx。
若你仍在用本包,配置:
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
并安装插件:https://plugins.jetbrains.com/plugin/26071-mcp-server
前置条件:IDE 已打开;插件已装;Node 18+(Node 16 会报 Cannot find module 'node:path')。代理默认连 127.0.0.1 上的 IDE,会接触本机 IDE 与项目,不是无本地读取。
配置位置:客户端 MCP 的 command / args。多开 IDE 时再加:
"env": {
"IDE_PORT": "<port of IDE's built-in webserver>"
}
低风险第一次调用:只做一次连通性请求,让客户端通过代理问 IDE 当前项目的只读信息(例如打开了哪个项目)。证据没有点名工具或参数。不要先改文件、运行构建或执行 IDE 写操作。
成功信号:代理进程拉起,客户端不再报连不上 IDE;多开时 IDE_PORT 指向你指定的那一个。若仍连错实例,先改端口,不要假设默认一定对。
使用案例
案例 1:把 MCP 客户端接到正在运行的单个 IDE。使用默认 127.0.0.1 与上面的 npx 配置(或 2025.2+ 内置)。证据只保证「代理请求到 IDE」,没有写工具清单。因此能确认的是:请求到达本机 IDE。
案例 2:本机同时开了多个带 MCP 的 IDE,要钉住其中一个。在配置里加 IDE_PORT。证据还说可以指定不同的 address/host,但 locator 在「specify a different address/host:」处截断,没有给出环境变量名。因此只把 IDE_PORT 当已证实的选择方式;host 不要臆造变量。
使用边界
仓库不再维护,2025.2+ 应使用内置能力。历史路径依赖 @jetbrains/mcp-proxy、MCP Server 插件和 Node 18+。默认只连本机 127.0.0.1。没有工具名、权限模型或官方 undo。代理能把客户端请求送到 IDE,等于把项目与 IDE 能力暴露给该客户端。证据没有写端口如何查看,也没有写非本机暴露的安全步骤。