项目简介

JetBrains MCP Proxy Server 是一个代理服务器,它允许 MCP 客户端(如 Claude Desktop)通过 Model Context Protocol 访问 JetBrains IDE (例如 IntelliJ IDEA, PyCharm) 的功能。它充当中间层,将 MCP 客户端的请求转发到 IDE,并将 IDE 的响应返回给客户端。

主要功能点

  • 工具代理:将来自 MCP 客户端的工具列表请求和工具调用请求转发到运行中的 JetBrains IDE。
  • 自动发现IDE:自动检测并连接到正在运行的 JetBrains IDE 实例,通过扫描端口或使用指定端口。
  • 工具变更通知:当 IDE 中可用的工具发生变化时,向 MCP 客户端发送通知。

安装步骤

  1. 安装 Node.js 和 pnpm:如果你的机器上没有安装 Node.js 和 pnpm,请先安装。例如,在 macOS 上可以使用 Homebrew:
    brew install node pnpm
  2. 构建项目:克隆此仓库到本地后,在终端中进入仓库根目录,运行以下命令构建项目:
    pnpm build

服务器配置 (用于 MCP 客户端,例如 Claude Desktop)

要将此 MCP 服务器与 MCP 客户端(如 Claude Desktop)配合使用,需要在客户端的配置文件中添加服务器配置信息。以 Claude Desktop 为例,你需要编辑 'claude_desktop_config.json' 文件,并添加 'mcpServers' 配置项。

以下是一个配置示例,你需要将其添加到 'claude_desktop_config.json' 文件中:

{
  "mcpServers": {
    "jetbrains": {  // "jetbrains":服务器名称,可以自定义,用于在客户端中标识该服务器
      "command": "npx", // "command":启动服务器的命令,这里使用 npx 来运行 @jetbrains/mcp-proxy 包
      "args": ["-y", "@jetbrains/mcp-proxy"] // "args":传递给命令的参数
    }
  }
}

参数说明:

  • 'server name': 服务器名称,可以自定义,用于在客户端配置中引用和识别该服务器。例如 '"jetbrains"'。
  • 'command': 启动 MCP 服务器的命令。这里使用 '"npx"',它允许你运行本地安装或全局安装的 npm 包。
  • 'args': 传递给 'command' 的参数。
    • '"-y"': 'npx' 的参数,用于自动同意安装 '@jetbrains/mcp-proxy' 包(如果尚未安装)。
    • '"@jetbrains/mcp-proxy"': 指定要执行的 npm 包,即构建后的 JetBrains MCP Proxy Server 包。

可选配置:指定 IDE 端口

如果你运行了多个 IDE 实例,或者需要连接到特定端口的 IDE,可以在配置中添加 'env' 字段来指定 'IDE_PORT' 环境变量:

{
  "mcpServers": {
    "jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"],
      "env": {
        "IDE_PORT": "<IDE 内置 веб-сервера порты>" // "IDE_PORT":JetBrains IDE 内置 веб-сервера порты,替换为实际端口号
      }
    }
  }
}
  • 'env': 允许为服务器进程设置环境变量。
  • 'IDE_PORT': 指定 JetBrains IDE 内置 веб-сервера порты。你需要将 '<IDE 内置 веб-сервера порты>' 替换为你的 JetBrains IDE 实例实际使用的端口号。通常情况下,JetBrains IDE 会在启动时自动分配一个端口,你可以在 IDE 的设置中找到或配置端口号。

基本使用方法

  1. 确保 JetBrains IDE 运行并安装 MCP Server 插件
  2. 配置 MCP 客户端
    • 根据你的 MCP 客户端 (如 Claude Desktop) 的文档,配置 'mcpServers' 并使用上面提供的配置信息。
  3. 连接和使用
    • 启动 MCP 客户端。客户端应该能够自动连接到 JetBrains MCP Proxy Server,并通过代理服务器发现和使用 JetBrains IDE 提供的工具。

信息

分类

开发者工具