Прокси-сервер JetBrains MCP

Сервер перенаправляет запросы от клиента в JetBrains IDE.

Установить плагин MCP Server

https://plugins.jetbrains.com/plugin/26071-mcp-server

Related MCP server: Code Analysis MCP Server

Установка VS-кода

Для установки в один клик нажмите одну из кнопок установки ниже:

Ручная установка

Добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав 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 Server и добавления JSON в файл конфигурации перезапустите Claude Desktop и убедитесь, что продукт Jetbrains открыт, прежде чем перезапускать Claude Desktop.

Конфигурация

Если вы используете несколько IDE с сервером MCP и хотите подключиться к определенной из них, добавьте в конфигурацию сервера MCP:

"env": {
  "IDE_PORT": "<port of IDE's built-in webserver>"
}

По умолчанию мы подключаемся к IDE по адресу 127.0.0.1, но вы можете указать другой адрес/хост:

"env": {
  "HOST": "<host/address of IDE's built-in webserver>"
}

Чтобы включить ведение журнала, добавьте:

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

Поиск неисправностей

Требования к версии Node.js

Проблема: Сообщение об ошибке: Cannot find module 'node:path'

Решение: MCP Proxy не работает на Node 16. Обновите установку Node.js до версии 18 или более поздней. Убедитесь, что command в конфигурации указывает на правильную версию Node.js. Попробуйте использовать полный путь к последней версии NodeJS.

MacOS: плагин не может обнаружить Node.js, установленный через nvm

Проблема: на MacOS, если у вас установлен Node.js через nvm (Node Version Manager), плагин MCP Server может не обнаружить вашу установку 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 и т. д.)

Проблема: При попытке подключения к прокси JetBrains MCP из внешних клиентов, контейнеров Docker или сторонних приложений (например, LibreChat) запросы к конечным точкам, таким как 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 для сборки проекта.