Gradle MCP
MCP-сервер Gradle для агентов: карта проекта, запуск задач, тесты, аудит зависимостей, поиск по исходникам и Kotlin REPL
- 68 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запускает задачи Gradle и тесты на вашей машине с правами пользователя
- Kotlin REPL выполняет код с классами проекта
Установка
- Работает в
Ручная установка
{
"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: агент создает, дорабатывает, отлаживает и проверяет их
MCP-сервер превращает GitHub Projects v2 в очередь задач для агентов: они берут работу, отчитываются и тратят бюджет токенов.
MCP-сервер git на 28 инструментов: агент клонирует, коммитит, ветвит, сливает и перебазирует в локальных репозиториях.
Сборщик Java-проектов с MCP-режимом: агент запускает компиляцию, тесты и запуск через команды сборки проекта
add-mcp одной командой прописывает MCP-сервер в конфигурации 25 агентов: Claude Code, Codex, Cursor, VS Code, Zed и других
MCP DevTools заменяет десяток MCP-серверов одним бинарником на Go: поиск, загрузка страниц, документация пакетов, GitHub.
Коротко о README
README перечисляет возможности, требование JDK 21, два способа запуска через jbang с готовым JSON для клиента и пять встроенных скиллов. Полная документация лежит на сайте проекта.