Gradle MCP

MCP-сервер Gradle для агентов: карта проекта, запуск задач, тесты, аудит зависимостей, поиск по исходникам и Kotlin REPL

  • 68 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Запускает задачи Gradle и тесты на вашей машине с правами пользователя
  • Kotlin REPL выполняет код с классами проекта
Все причины и проверки

rnett/gradle-mcp

Установка

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

{
  "mcpServers": {
    "gradle": {
      "command": "jbang",
      "args": ["run", "--quiet", "--fresh", "gradle-mcp@rnett"]
    }
  }
}

Нужны jbang и JDK 21 или новее. Для снимков подставьте gradle-mcp-snapshot@rnett.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Запускает задачи Gradle и тесты на вашей машине с правами пользователя
  • Kotlin REPL выполняет код с классами проекта

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

gradle-mcp дает агенту работать со сборкой Gradle без разбора выводов в терминале. Инструменты показывают структуру многомодульного проекта, задачи и свойства, запускают сборку в фоне и возвращают вывод только нужных задач. Тесты идут с фильтром, и для каждого теста доступны логи и трассировка стека. Отдельные возможности: поиск по исходникам зависимостей, стандартной библиотеки JDK и самого Gradle, постоянный Kotlin REPL с классами проекта, отрисовка Compose UI в изображения для визуальной проверки, поиск по документации Gradle и публикация Develocity Build Scans. Форматы данных сжаты, чтобы экономить контекст. Встроены пять скиллов: `using-gradle`, `authoring-gradle-builds`, advanced-gradle-dependencies, interacting-with-project-runtime и `verifying-compose-ui`. Сервер запускают через jbang, нужен JDK 21 или новее. Корень проекта по умолчанию задает переменная GRADLE_MCP_PROJECT_ROOT.

Для кого. Разработчикам на Kotlin и Java, которые ведут сборку на Gradle и хотят, чтобы Claude Code или Cursor сами запускали тесты и разбирали зависимости.

Подходит, если

  • Тесты в многомодульном проекте падают, и нужны логи и трассировка стека упавших случаев
  • Конфликт версий зависимостей надо разобрать через варианты и capabilities
  • Нужно найти в исходниках библиотеки, как работает конкретный метод
  • Хочется проверить кусок логики в Kotlin REPL с класспасом проекта, не собирая приложение
  • Требуется отрисовать компонент Compose и увидеть его как изображение

Не подходит, если

  • На машине нет JDK 21 или новее: сервер без него не запустится
  • Проект собирается на Maven или Bazel: сервер рассчитан на Gradle
  • Нужна загрузка и индексация исходников как отдельный сервис: автор переносит эту часть в отдельный MCP или CLI
  • Сборку нельзя запускать с рабочей машины агента: инструменты исполняют задачи Gradle

Пример запроса к агенту

Запусти тесты модуля :app с фильтром по классу CheckoutTest и покажи трассировку стека у упавших

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

GRADLE_MCP_PROJECT_ROOT
Корень Gradle-проекта по умолчанию, если вызов не передает projectRoot

Ограничения

  • Нужен JDK 21 или новее, его ставит и jbang.
  • Часть для загрузки и индексации исходников автор собирается вынести в отдельный MCP или CLI.
  • Если ошибки связаны с Class Data Sharing из-за нативных агентов защитного ПО, в команду jbang добавляют --no-cds.
  • Задачи Gradle выполняются на вашей машине с правами вашего пользователя.
  • Сервер работает со сборками Gradle и не заменяет Maven или Bazel. Снимки версий запускает отдельная команда `gradle-mcp-snapshot@rnett`.

Как отключить. Уберите блок gradle из mcpServers в конфигурации клиента. Скиллы вшиты в сервер и отдельного удаления не требуют.

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

Как подключить gradle-mcp к Claude Code или Cursor?

Добавьте в mcpServers блок gradle с command jbang и args run, --quiet, --fresh, gradle-mcp@rnett. Нужны jbang и JDK 21 или новее. Снимки версий запускает gradle-mcp-snapshot@rnett.

Что такое встроенные скиллы?

Это пять руководств внутри сервера: `using-gradle` для запуска и диагностики, `authoring-gradle-builds` для правки сборки, advanced-gradle-dependencies для сложных зависимостей, interacting-with-project-runtime для Kotlin REPL и `verifying-compose-ui` для проверки Compose.

Что делать с ошибками CDS?

Добавьте --no-cds к команде jbang. Такие ошибки дают нативные JVMTI-агенты защитного ПО, например SentinelOne.

Что делает инструмент Kotlin REPL?

Он запускает постоянную сессию Kotlin с классами проекта в пути поиска. В ней агент проверяет утилиты и пробует API, не собирая приложение целиком.

Можно ли смотреть Compose-компоненты?

Да, скилл `verifying-compose-ui` рендерит компоненты Compose в изображения из среды выполнения проекта для визуальной проверки агентом.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их

ПлагинРасширенный доступ10,9 тыс.Звезды репозитория

MCP-сервер превращает GitHub Projects v2 в очередь задач для агентов: они берут работу, отчитываются и тратят бюджет токенов.

MCP-серверШирокий доступ105Звезды репозитория

MCP-сервер git на 28 инструментов: агент клонирует, коммитит, ветвит, сливает и перебазирует в локальных репозиториях.

MCP-серверШирокий доступ245Звезды репозитория
Официальный

Сборщик Java-проектов с MCP-режимом: агент запускает компиляцию, тесты и запуск через команды сборки проекта

MCP-серверШирокий доступ325Звезды репозитория

add-mcp одной командой прописывает MCP-сервер в конфигурации 25 агентов: Claude Code, Codex, Cursor, VS Code, Zed и других

CLIРасширенный доступ321Звезды репозитория

MCP DevTools заменяет десяток MCP-серверов одним бинарником на Go: поиск, загрузка страниц, документация пакетов, GitHub.

MCP-серверРасширенный доступ165Звезды репозитория

Коротко о README

README перечисляет возможности, требование JDK 21, два способа запуска через jbang с готовым JSON для клиента и пять встроенных скиллов. Полная документация лежит на сайте проекта.

Бейдж для README

Сообщить о проблеме