⚙

MCP代理服务器

JetBrains MCP代理服务器用于在客户端和JetBrains IDE之间转发请求，支持VS Code和Claude Desktop等外部工具的集成。

作者 By JetBrains

本地部署 IDE集成代理服务器

GitHub

⚠️ 已弃用

此存储库不再维护。 自2025.2版本以来，核心功能已集成到所有基于IntelliJ的IDE中。内置功能适用于SSE和基于JVM的代理（用于STDIO），因此不再需要此NPM包。

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

问题与支持： 对于与内置MCP功能相关的错误或功能请求，请使用 JetBrains YouTrack.

JetBrains MCP代理服务器

服务器将客户端的请求代理到JetBrains IDE。

安装MCP服务器插件

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

VS代码安装

对于一键安装，请单击下面的安装按钮之一：

手动安装

将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P 和打字 Preferences: Open User Settings (JSON).

JSON``` 1 2 3 4 5 6 7 8 9 10{ “mcp”: { “servers”: { “jetbrains”: { “command”: “npx”, “args”: [“-y”, “@jetbrains/mcp-proxy”] } } } }


您可以选择将其添加到名为的文件中 `.vscode/mcp.json` 在您的工作空间中：


JSON```
1
2
3
4
5
6
7
8{
  "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.

JSON``` 1 2 3 4 5 6 7 8{ “mcpServers”: { “jetbrains”: { “command”: “npx”, “args”: [“-y”, “@jetbrains/mcp-proxy”] } } }


安装MCP服务器插件并将JSON添加到配置文件后，重新启动Claude Desktop，并确保Jetbrains产品已打开，然后再重新启动克劳德Desktop。


## 配置


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


JSON```
1
2
3"env": {
  "IDE_PORT": "<port of IDE's built-in webserver>"
}

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

JSON``` 1 2 3”env”: { “HOST”: “<host/address of IDE’s built-in webserver>” }


要启用日志记录，请添加：


JSON```
1
2
3"env": {
  "LOG_ENABLED": "true"
}

故障排除

Node.js版本要求

问题： 错误消息： Cannot find module 'node:path'

解决方案： MCP代理在节点16上不起作用。将Node.js安装升级到版本18或更高版本。确保 command in config指向正确的Node.js版本。尝试使用NodeJS最新版本的完整路径。

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

问题： 在MacOS上，如果您通过nvm（节点版本管理器）安装了Node.js，MCP服务器插件可能无法检测到您的Node.js安装。

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

BASH``` 1which npx &>/dev/null && sudo ln -sf ”$(which npx)” /usr/local/bin/npx


此单行程序检查您的路径中是否存在npx，并创建具有适当权限的必要符号链接。


### 将MCP与外部客户端或Docker容器（LibreChat、Cline等）一起使用


**问题：** 当试图从外部客户端、Docker容器或第三方应用程序（如LibreChat）连接到JetBrains MCP代理时，会向端点发出请求，例如[http://host.docker.internal:6365/api/mcp/list_tools可能返回404错误或无法连接。](http://host.docker.internal:6365/api/mcp/list_tools%E5%8F%AF%E8%83%BD%E8%BF%94%E5%9B%9E404%E9%94%99%E8%AF%AF%E6%88%96%E6%97%A0%E6%B3%95%E8%BF%9E%E6%8E%A5%E3%80%82)
**解决方案：** 有两个关键问题需要解决：


1. 启用外部连接：


在JetBrains IDE中，在 *设置|构建、执行、部署|调试器*.


1. 配置LAN IP和端口：


使用计算机的LAN IP地址，而不是 `host.docker.internal`
在配置中明确设置IDE_PORT和HOST
LibreChat或类似外部客户端的示例配置：


YAML```
1
2
3
4
5
6
7mcpServers:
  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）

如何构建

在macOS上测试
brew install node pnpm
跑 pnpm build 建设项目