使用说明

项目简介

JetBrains MCP Proxy Server 是一个 MCP (Model Context Protocol) 代理服务器，旨在连接 MCP 客户端（如 Claude Desktop）和 JetBrains IDE (如 IntelliJ IDEA, PyCharm)。它本身不提供资源或工具，而是作为一个桥梁，将客户端的工具调用请求转发到安装了 MCP Server 插件的 JetBrains IDE，并返回执行结果。

主要功能点

工具代理: 代理 MCP 客户端的工具列表请求和工具调用请求到 JetBrains IDE。
IDE 集成: 依赖 JetBrains IDE 上的 MCP Server 插件提供实际的工具和功能。
端口扫描与自动发现: 自动扫描并连接到正在运行的 JetBrains IDE 实例，简化配置。
配置灵活: 支持通过环境变量配置 IDE 连接地址、端口和日志开关。
工具状态通知: 在 IDE 工具列表发生变化时，向客户端发送通知。

安装步骤

安装 Node.js 和 pnpm: 如果你的机器上没有安装 Node.js 和 pnpm，请先安装。macOS 用户可以使用 'brew install node pnpm' 命令安装。
全局安装 @jetbrains/mcp-proxy: 打开终端，运行以下命令全局安装 JetBrains MCP Proxy Server：
```
pnpm install -g @jetbrains/mcp-proxy
```
安装 JetBrains MCP Server 插件: 在你的 JetBrains IDE 中，打开插件市场 (Plugins Marketplace)，搜索 "MCP Server" 并安装 "MCP Server" 插件 (插件ID: '26071-mcp-server')。安装后重启 IDE。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令才能连接。以下是 Claude Desktop 的 'claude_desktop_config.json' 配置文件示例，展示了如何配置 JetBrains MCP Proxy Server：

{
  "mcpServers": {
    "jetbrains": {  // 服务器名称，可以自定义
      "command": "npx",  // 启动命令，这里使用 npx 来运行全局安装的 @jetbrains/mcp-proxy
      "args": ["-y", "@jetbrains/mcp-proxy"] // 启动参数，-y 表示自动确认安装 @jetbrains/mcp-proxy (如果尚未安装)
    }
  }
}

更多配置选项 (可选):

你还可以通过 'env' 字段在 'claude_desktop_config.json' 中配置额外的环境变量来定制服务器行为：

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"],
      "env": {
        "IDE_PORT": "<IDE webserver 端口>",  // 指定 JetBrains IDE 内置 webserver 的端口，默认会自动扫描 63342-63352 端口范围
        "HOST": "<IDE webserver 主机地址>",  // 指定 JetBrains IDE webserver 的主机地址，默认为 127.0.0.1
        "LOG_ENABLED": "true"  // 启用日志输出，将日志信息输出到标准错误 (stderr)
      }
    }
  }
}

请根据你的实际需求配置 'IDE_PORT' 和 'HOST'，通常情况下，如果 IDE 运行在本地默认端口，则无需配置。

基本使用方法

启动 JetBrains IDE 并确保 MCP Server 插件已安装并启用。
配置 MCP 客户端 (如 Claude Desktop) 的配置文件 'claude_desktop_config.json'，添加上述服务器配置。
启动 MCP 客户端 (如 Claude Desktop)。 客户端将根据配置连接到 JetBrains MCP Proxy Server。
客户端可以通过 MCP 协议请求工具列表和调用工具。 这些请求将通过 Proxy Server 转发到 JetBrains IDE 进行处理。

注意: JetBrains MCP Proxy Server 依赖于 JetBrains IDE 和 MCP Server 插件。请确保 IDE 和插件正确安装并运行，Proxy Server 才能正常工作。

关键词