使用说明

项目简介

MCP JetBrains Proxy 是一个基于 Python 开发的 MCP (Model Context Protocol) 服务器，旨在作为 JetBrains IDE 的代理，为 LLM (大型语言模型) 应用提供上下文服务。它允许 LLM 客户端通过标准的 MCP 协议与 JetBrains IDE 集成，利用 IDE 提供的各种工具和功能。

主要功能点

工具代理: 代理 JetBrains IDE 提供的工具，将 IDE 的功能暴露给 LLM 客户端。
动态工具发现: 自动发现和更新 JetBrains IDE 提供的工具列表，并及时通知客户端。
标准 MCP 协议: 完全遵循 MCP 协议规范，易于与各种 MCP 客户端集成。
灵活的端点管理: 自动搜索 JetBrains IDE 的 MCP 端点，并支持通过环境变量手动指定。
健康检查和重试机制: 具备端点健康检查和请求重试机制，确保服务的稳定性和可靠性。

安装步骤

安装 Python 包: 打开终端，运行以下命令安装 'mcp-jetbrains-proxy' 包：

pip install mcp_jetbrains_proxy

服务器配置

MCP 客户端需要配置连接到 MCP JetBrains Proxy 服务器的信息。以下是一个典型的 JSON 格式配置示例，你需要将其配置到你的 MCP 客户端中：

{
  "serverName": "jetbrains/proxy",  // MCP 服务器名称，由 MCP JetBrains Proxy 定义
  "command": "mcp-jetbrains-proxy", // 启动 MCP JetBrains Proxy 服务器的命令
  "args": []                         // 启动参数，这里为空，如有需要可以添加命令行参数，例如 '--no-stdout' 关闭标准输出日志
}

参数说明:

'serverName': MCP 服务器的名称，客户端通过此名称识别服务器类型。
'command': 启动 MCP JetBrains Proxy 服务器的可执行命令。确保 'mcp-jetbrains-proxy' 命令在你的系统 PATH 环境变量中，或者使用绝对路径。
'args': 启动命令的参数列表。默认为空，可以根据需要添加参数，例如 '--no-stdout' 可以禁用标准输出日志。

基本使用方法

启动 MCP JetBrains Proxy 服务器: 在终端中运行 'mcp-jetbrains-proxy' 命令即可启动服务器。默认情况下，服务器会监听标准输入和标准输出 (stdio) 进行通信。
配置 MCP 客户端: 在你的 LLM 应用或 MCP 客户端中，配置连接到 MCP JetBrains Proxy 服务器，使用上面提供的 JSON 配置信息。
LLM 客户端与服务器交互: LLM 客户端通过 MCP 协议与 MCP JetBrains Proxy 服务器进行通信，可以请求工具列表、调用工具等操作。 MCP JetBrains Proxy 服务器会代理这些请求到 JetBrains IDE，并将结果返回给客户端。

注意:

确保 JetBrains IDE 已经安装并运行了 MCP Server 插件 (MCP JetBrains Server)。
MCP JetBrains Proxy 服务器需要能够访问到 JetBrains IDE 暴露的 MCP 端点。通常情况下，如果 MCP Server 插件在 IDE 中正常运行，并且 MCP JetBrains Proxy 服务器和 IDE 在同一台机器上，则可以自动发现端点。
可以通过设置环境变量 'MCP_IDE_PORT' 来手动指定 JetBrains IDE 的 MCP 端点端口号。

关键词