local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

The MCP server proxies requests from client to JetBrains IDE, allowing tools like Claude Desktop to interface with JetBrains IDEs.

JetBrains MCP 代理服务器

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

安装 MCP 服务器插件

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

与 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 服务器运行多个 IDE，并且想要连接到特定的 IDE，请添加到 MCP 服务器配置中：

"env": {
  "IDE_PORT": "<port of IDE's built-in webserver>"
}

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

"env": {
  "HOST": "<host/address of IDE's built-in webserver>"
}

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

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

故障排除

Node.js 版本要求

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

解决方案： MCP Proxy 在 Node 16 上无法正常工作。请将您的 Node.js 安装升级到 18 或更高版本。确保配置中的command指向正确的 Node.js 版本。请尝试使用最新版本 NodeJS 的完整路径。

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

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

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

which 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 错误或连接失败。**解决方案：**有两个关键问题需要解决：

启用外部连接：

在您的 JetBrains IDE 中，在设置 | 构建、执行、部署 | 调试器中启用“可以接受外部连接”。

配置 LAN IP 和端口：

使用您机器的 LAN 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）

如何构建

在 macOS 上测试
brew install node pnpm
运行pnpm build来构建项目

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested