JetBrains MCP Server

официальный

Работайте с кодом в IDE JetBrains

Документация

⚠️ Устарело

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

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

Проблемы и поддержка: Для сообщений об ошибках или запросов функций, связанных со встроенной функциональностью MCP, используйте JetBrains YouTrack.

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

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

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

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 или не подключаться. Решение: Необходимо решить две ключевые проблемы:

Включите внешние подключения:

В вашей IDE JetBrains включите «Can accept external connections» в Settings | Build, Execution, Deployment | Debugger.

Настройте с использованием локального 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)

Как собрать

Протестировано на macOS
brew install node pnpm
Запустите pnpm build, чтобы собрать проект