你是否曾经希望AI助手能够直接与JetBrains IDE交互,让AI辅助你的编码工作?今天要介绍的开源项目JetBrains代理服务器,正是为了实现这个目标而设计的。它由JetBrains官方开发,充当代理,承接客户端发往JetBrains IDE的请求,在二者间搭建数据传输桥梁。
项目基本信息
| 信息项 | 详情 |
|---|---|
| 项目名称 | JetBrains代理服务器 |
| GitHub地址 | https://github.com/JetBrains/mcp-jetbrains |
| 项目描述 | 该服务器充当代理,承接客户端发往 JetBrains IDE 的请求,在二者间搭建数据传输桥梁,确保请求准确高效传递,助力客户端与 JetBrains IDE 顺畅交互,优化使用体验 。 |
| 作者 | JetBrains |
| 开源协议 | Unknown |
| 开源状态 | 公开状态 |
| Languages | TypeScript |
| 支持平台 | Windows / macOS / Linux |
| 最后更新 | 2026-04-23 |
一、项目介绍
JetBrains代理服务器是JetBrains官方开发的MCP工具,让MCP客户端(如Claude Desktop、VS Code等)能够与JetBrains IDE进行交互。它通过代理机制,将客户端的请求传递到IDE,实现AI辅助编码。
这个项目的核心组件包括:
- MCP服务器插件:在JetBrains IDE中安装
- MCP代理:处理客户端与IDE之间的通信
通过这个工具,AI助手可以:
- 获取代码上下文
- 辅助代码编写
- 提供智能建议
二、核心优势
官方支持
由JetBrains官方开发和维护,与IDE兼容性好。
无缝集成
在Claude Desktop、VS Code等客户端中直接使用。
灵活配置
支持指定IDE端口和主机地址。
多IDE支持
兼容IntelliJ IDEA、PyCharm、WebStorm等JetBrains IDE。
易于使用
简单的配置步骤,快速上手。
三、适用场景
AI辅助编码
让AI助手理解你的代码上下文,提供智能建议。
代码解释
AI可以解释选中的代码块。
代码生成
根据自然语言描述生成代码。
代码审查
AI可以分析代码质量并提供改进建议。
四、安装教程
系统要求
| 工具 | 用途 | 下载/安装方式 |
|---|---|---|
| Node.js | 运行环境 | [https://nodejs.org/] (版本要求:18.0 或以上) |
| JetBrains IDE | 开发环境 | [https://jetbrains.com] (如IntelliJ IDEA、PyCharm等) |
| MCP客户端 | 如Claude Desktop、VS Code等 | 根据客户端官网下载 |
安装步骤
第一步:安装JetBrains IDE插件
在JetBrains IDE中:
- 打开设置(Settings/Preferences)
- 转到Plugins
- 搜索"MCP Server"
- 安装插件:https://plugins.jetbrains.com/plugin/26071-mcp-server
第二步:配置MCP客户端
对于VS Code:
在用户设置中添加:
{
"mcp": {
"servers": {
"jetbrains": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
}
}
}
}对于Claude Desktop:
找到配置文件,添加:
{
"mcpServers": {
"jetbrains": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"]
}
}
}第三步:重启客户端
保存配置后,重启Claude Desktop或VS Code。确保在重启之前已打开JetBrains IDE。
五、配置选项
指定IDE端口
如果运行多个IDE,可以指定端口:
{
"env": {
"IDE_PORT": "<IDE内置Web服务器的端口>"
}
}指定主机地址
{
"env": {
"HOST": "<IDE内置Web服务器的主机/地址>"
}
}启用日志
{
"env": {
"LOG_ENABLED": "true"
}
}六、外部客户端配置
当从外部客户端(如LibreChat、Docker容器)连接时:
第一步:在IDE中启用外部连接
设置 -> 构建、执行、部署 -> 调试器 -> 启用"可以接受外部连接"
第二步:使用LAN IP配置
{
"mcpServers": {
"intellij": {
"command": "npx",
"args": ["-y", "@jetbrains/mcp-proxy"],
"env": {
"IDE_PORT": "6365",
"HOST": "192.168.0.12"
}
}
}
}七、常见问题
问题1:Node.js版本错误
解决方案:需要Node.js 18或更高版本。升级Node.js并使用完整路径。
问题2:MacOS上插件无法检测nvm安装的Node
解决方案:创建符号链接:
sudo ln -sf "$(which npx)" /usr/local/bin/npx问题3:外部客户端连接失败
解决方案:启用IDE的外部连接设置,使用LAN IP而非localhost。
问题4:多个IDE同时运行
解决方案:使用IDE_PORT环境变量指定目标IDE端口。
问题5:插件未生效
解决方案:确保IDE中已安装MCP Server插件并重启IDE。
八、总结
JetBrains代理服务器是JetBrains官方开发的MCP工具,让AI助手能够与JetBrains IDE进行交互。
这个项目的最大价值在于:
- 官方支持:JetBrains官方维护
- 无缝集成:与IDE深度集成
- 灵活配置:支持端口和主机配置
- 多客户端:支持Claude Desktop、VS Code等
- 易于使用:简单安装配置
如果你是JetBrains IDE用户,并且希望用AI辅助编码,JetBrains代理服务器是一个非常实用的工具。
可以指定IDE端口。
外部客户端需要LAN IP配置。
MacOS用户注意nvm兼容性。
日志功能便于调试。
Node.js 18+是硬性要求。