项目简介
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 客户端发送通知。
安装步骤
- 安装 Node.js 和 pnpm:如果你的机器上没有安装 Node.js 和 pnpm,请先安装。例如,在 macOS 上可以使用 Homebrew:
brew install node pnpm - 构建项目:克隆此仓库到本地后,在终端中进入仓库根目录,运行以下命令构建项目:
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 的设置中找到或配置端口号。
基本使用方法
- 确保 JetBrains IDE 运行并安装 MCP Server 插件:
- 确认你已经安装并启用了 "MCP Server" 插件。插件安装地址:https://plugins.jetbrains.com/plugin/26071-mcp-server
- 启动你的 JetBrains IDE (如 IntelliJ IDEA, PyCharm)。
- 配置 MCP 客户端:
- 根据你的 MCP 客户端 (如 Claude Desktop) 的文档,配置 'mcpServers' 并使用上面提供的配置信息。
- 连接和使用:
- 启动 MCP 客户端。客户端应该能够自动连接到 JetBrains MCP Proxy Server,并通过代理服务器发现和使用 JetBrains IDE 提供的工具。
信息
分类
开发者工具