⚠️ 已弃用

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

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

问题与支持： 如果遇到与内置 MCP 功能相关的 bug 或功能请求，请使用 JetBrains YouTrack。

JetBrains MCP 代理服务器

该服务器代理客户端向 JetBrains IDE 发出的请求。

安装 MCP 服务器插件

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 服务器插件并添加 JSON 到配置文件后，重启 Claude Desktop，并确保在重启 Claude Desktop 之前打开 Jetbrains 产品。

配置

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

"env": {
  "IDE_PORT": "<IDE 内置 Web 服务器端口>"
}

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

"env": {
  "HOST": "<IDE 内置 Web 服务器的主机/地址>"
}

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

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

故障排除

Node.js 版本要求

问题： 错误消息：无法找到模块 'node:path'

解决方案： MCP 代理不支持 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 错误或无法连接。 解决方案： 需要解决两个关键问题：

1. 启用外部连接：

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

2. 使用局域网 IP 和端口进行配置：

使用您的机器的局域网 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 来构建项目