⚠️ Устарело

Этот репозиторий больше не поддерживается. Основная функциональность была интегрирована во все основанные на IntelliJ IDE начиная с версии 2025.2. Встроенная функциональность работает с SSE и прокси на основе JVM (для STDIO), поэтому данный пакет NPM больше не требуется.

Миграция: Ознакомьтесь с официальной документацией для получения подробной информации об использовании встроенной функциональности.

Проблемы и поддержка: По вопросам, связанным со встроенными функциями MCP (баги или предложения по доработкам), используйте JetBrains YouTrack.

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

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

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

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

Установка в VS Code

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

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

Добавьте следующий 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": "<порт встроенного веб-сервера IDE>"
}

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

"env": {
  "HOST": "<хост/адрес встроенного веб-сервера IDE>"
}

Для включения логирования добавьте:

"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, указывающую на ваш исполняемый файл npx от nvm:

which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx

Эта команда проверяет, существует ли npx в вашем PATH, и создает необходимую символическую ссылку с правильными правами доступа.

Использование MCP с внешними клиентами или Docker-контейнерами (LibreChat, Cline и т.д.)

Проблема: При попытке подключения к прокси JetBrains MCP из внешних клиентов, Docker-контейнеров или сторонних приложений (например, LibreChat), запросы к таким конечным точкам, как http://host.docker.internal:6365/api/mcp/list_tools, могут возвращать ошибки 404 или не устанавливать соединение. Решение: Существуют две ключевые проблемы, которые необходимо решить: 1. Разрешить внешние подключения:

В вашей JetBrains IDE включите параметр "Can accept external connections" в разделе Settings | Build, Execution, Deployment | Debugger.

1. Настроить с использованием LAN 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 для сборки проекта