JetBrains MCP Proxy Server

⚠️ 已弃用

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

迁移： 请参阅官方文档，了解如何使用内置功能。

问题与支持： 如有与内置 MCP 功能相关的错误报告或功能请求，请使用 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；重启 Claude Desktop 前，请确保 Jetbrains 产品已打开。

配置

如果你运行着多个启用了 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 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 容器中使用 MCP（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. 使用 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）

如何构建

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