PyCharm MCP: проверка кода инспекциями IDE через Claude Code и Codex

yingsf/pycharm-code-quality-mcp· Проверено 12.11.2026· 2на GitHub

Связывает агента с PyCharm: проверить код инспекциями IDE и SonarQube for IDE, собрать замечания по изменённым файлам Git. В PyCharm 2025.2 и новее MCP-сервер встроен в саму IDE.

2 реализации:

Только читает: берёт get_file_problems у встроенного MCP-сервера PyCharm, добавляет SonarQube for IDE, если он стоит, и убирает дубли замечаний.

Как подключить

Что сделать до подключения

Поставить бинарник скриптом install-macos.sh или install-windows.ps1 со страницы Releases: он сам регистрирует сервер в Codex и Claude Code

В PyCharm: Settings → Tools → MCP Server → Enable MCP Server, в Exposed Tools включить get_file_problems

Нажать Copy HTTP Stream Config и передать скопированный JSON команде pycharm-code-quality-mcp jetbrains configure --json '<JSON>'

Проверить связь командой pycharm-code-quality-mcp doctor

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio pycharm \
  -- '<полный путь к pycharm-code-quality-mcp>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.pycharm]
command = "<полный путь к pycharm-code-quality-mcp>"
args = []

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "pycharm": {
      "command": "<полный путь к pycharm-code-quality-mcp>",
      "args": []
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "pycharm": {
      "type": "stdio",
      "command": "<полный путь к pycharm-code-quality-mcp>",
      "args": []
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "pycharm": {
      "command": "<полный путь к pycharm-code-quality-mcp>",
      "args": []
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "pycharm": {
      "command": "<полный путь к pycharm-code-quality-mcp>",
      "args": []
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "pycharm": {
        "type": "local",
        "command": ["<полный путь к pycharm-code-quality-mcp>"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "pycharm": {
      "command": "<полный путь к pycharm-code-quality-mcp>",
      "args": []
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "pycharm": {
      "command": "<полный путь к pycharm-code-quality-mcp>",
      "args": []
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

code_quality_statusпоказывает состояние проверок

code_quality_analyze_filesпроверяет до 200 файлов

code_quality_analyze_git_changesпроверяет изменения Git

code_quality_analyze_projectпроверяет весь репозиторий

code_quality_clear_cacheсбрасывает кеш

jetbrains_ide_statusпроверяет связь с PyCharm

jetbrains_inspect_filesпрогоняет инспекции PyCharm по файлам

jetbrains_inspect_git_changesпрогоняет инспекции по изменениям

Прокси от JetBrains для IDE старше 2025.2: передаёт запросы клиента плагину MCP Server в открытой IDE. Больше не поддерживается.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Плагин MCP Server из JetBrains Marketplace (plugins.jetbrains.com/plugin/26071-mcp-server)

PyCharm должен быть открыт до запуска клиента

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-jetbrains \
  -- npx -y @jetbrains/mcp-proxy

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-jetbrains]
command = "npx"
args = ["-y", "@jetbrains/mcp-proxy"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-jetbrains": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-jetbrains": {
        "type": "local",
        "command": ["npx", "-y", "@jetbrains/mcp-proxy"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-jetbrains": {
      "command": "npx",
      "args": ["-y", "@jetbrains/mcp-proxy"]
    }
  }
}

Что попросить агента

«После правок проверь изменённые файлы и исправь замечания CRITICAL и MAJOR»Агент вызовет code_quality_analyze_git_changes, поправит код и запустит проверку повторно

«Проверь <файл>.py инспекциями PyCharm»Агент вызовет jetbrains_inspect_files с путём к файлу

«Прогони весь репозиторий и сведи замечания по уровням»Агент вызовет code_quality_analyze_project и сгруппирует результат по severity

«Проверь, видит ли сервер PyCharm и SonarQube»Агент вызовет code_quality_status и jetbrains_ide_status

Для каких задач

Проверить изменённые файлы теми же инспекциями, что показывает PyCharm

Прогнать весь репозиторий и получить список замечаний с уровнем серьёзности

Объединить замечания PyCharm и SonarQube for IDE без дублей

Исправить замечания уровня CRITICAL и MAJOR и перепроверить код

Ограничения

Репозиторий JetBrains/mcp-jetbrains больше не поддерживается: в IDE на базе IntelliJ с версии 2025.2 MCP-сервер встроен, прокси не нужен

PyCharm Code Quality MCP: 2 звезды на GitHub; готовые сборки только для macOS и Windows, на Linux — запуск из исходников

PyCharm Code Quality MCP не правит файлы и не запускает команды; к PyCharm он подключается только по локальному адресу localhost, 127.0.0.1 или ::1

Все файлы одного вызова должны лежать в одном проекте, инспекции PyCharm идут по одному файлу подряд

Если не работает

Ошибка Cannot find module 'node:path' у @jetbrains/mcp-proxy

Прокси не работает на Node 16. Поставьте Node.js 18 или новее и укажите в command полный путь к нужной версии.

macOS: плагин не находит Node.js, поставленный через nvm

Сделайте ссылку на npx в /usr/local/bin: which npx &>/dev/null && sudo ln -sf "$(which npx)" /usr/local/bin/npx.

doctor пишет [WARN] Degraded mode

Связи с PyCharm нет, и проверка идёт только через Sonar. Включите MCP Server в PyCharm, откройте get_file_problems и заново выполните jetbrains configure с JSON из Copy HTTP Stream Config.

Комментарий # noqa: Sxxx не отключает правило Sonar

SonarQube for IDE понимает только # NOSONAR. doctor показывает такие места и подсказывает замену.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
PyCharm Code Quality MCP	yingsf	2	локально	не нужен	8	23 июля 2026
JetBrains MCP Proxy Serverразработчик сервиса	JetBrains	963	локально	не нужен	—	7 января 2026

Частые вопросы

Есть ли в PyCharm свой MCP-сервер?

Есть: с версии 2025.2 он встроен во все IDE на базе IntelliJ, включая PyCharm, и прокси @jetbrains/mcp-proxy больше не нужен. Включается в Settings → Tools → MCP Server, адрес для клиента даёт кнопка Copy HTTP Stream Config.

Чем PyCharm Code Quality MCP отличается от встроенного сервера?

Встроенный сервер PyCharm отдаёт агенту 38 своих инструментов, включая запуск и правку. PyCharm Code Quality MCP берёт у него только get_file_problems, добавляет SonarQube for IDE и убирает дубли. Их можно держать в клиенте вместе.

Нужен ли SonarQube for IDE?

Нет. Без него сервер проверяет код только инспекциями PyCharm и сообщает, что Sonar недоступен. Если плагин стоит, сервер находит его сам на портах 64120–64130.

Как подключить к старому PyCharm без встроенного сервера?

Поставьте плагин MCP Server из JetBrains Marketplace и пропишите в клиенте npx -y @jetbrains/mcp-proxy. Откройте PyCharm до запуска клиента. Этот прокси JetBrains больше не развивает.

Как подключить PyCharm MCP к Claude Code?

Скрипт установки PyCharm Code Quality MCP сам выполняет claude mcp add --transport stdio --scope user pycharm-code-quality с путём к бинарнику. Вручную та же команда: путь по умолчанию $HOME/.local/bin/pycharm-code-quality-mcp.

Как подключить PyCharm MCP к Codex?

Выполните codex mcp add pycharm-code-quality -- "$HOME/.local/bin/pycharm-code-quality-mcp": абсолютный путь избавляет от зависимости от PATH. Скрипт установки делает это сам, если Codex уже стоит.

Работает ли сервер из России?

Серверы работают на вашем компьютере и говорят только с локальным PyCharm, код никуда не уходит; ключи и аккаунты не нужны.

PyCharm MCP: проверка кода инспекциями IDE через Claude Code и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы