SonarQube MCP-сервер: quality gate, покрытие и проблемы

💡 Не хочешь ничего устанавливать? Используй cloud.anythingmcp.com напрямую. Войди, нажми Connectors → SonarQube, вставь свои учётные данные, создай API-ключ MCP — готово. Без Docker, без git clone, без локального сервера.

SonarQube

Дай своему ИИ возможность читать SonarQube: проекты, статус quality gate, метрики (например, покрытие кода) и их историю, открытые проблемы по серьёзности и качеству ПО, анализы и ветки. SonarQube Server или SonarQube Cloud, только чтение, по пользовательскому токену.

Настройка

Настройка занимает около 3 минут. Тебе нужен SonarQube Server (подойдёт бесплатный Community Build) или аккаунт SonarQube Cloud хотя бы с одним проанализированным проектом, а также пользовательский токен.

1. Задай SONARQUBE_URL без /api и без завершающего слэша: https://sonarcloud.io для SonarQube Cloud в регионе ЕС, https://sonarqube.us для SonarQube Cloud в регионе США или адрес твоего SonarQube Server так, как ты открываешь его в браузере, включая context path, если он есть (например, https://sonar.example.com или https://example.com/sonarqube).
2. Создай пользовательский токен и вставь его в SONARQUBE_TOKEN без слова Bearer. На Server: аватар → My Account → Security, затем сгенерируй токен типа User. На Cloud: аватар → My Account → Access tokens → Personal Tokens, затем сгенерируй токен. Токены анализа проекта и глобальные токены анализа предназначены для запуска сканирований и не работают с Web API.
3. В SonarQube Cloud задай в SONARQUBE_ORGANIZATION ключ своей организации, он виден в URL sonarcloud.io/organizations/<key>. Cloud требует его, чтобы получать список проектов и искать проблемы. На Server оставь поле пустым.
4. Установи коннектор и запусти sonarqube_list_projects: он выведет проекты, доступные токену для просмотра, вместе с ключами проектов, которые принимают остальные инструменты.

Что читается: прошёл ли проект quality gate (OK или ERROR, с каждым невыполненным условием), текущие метрики, такие как coverage, duplicated_lines_density, ncloc и счётчики проблем software_quality_*, как эти метрики менялись от анализа к анализу, проблемы с фильтрацией по качеству ПО (SECURITY, RELIABILITY, MAINTAINABILITY), серьёзности и статусу, анализы проекта с их событиями, а также ветки с последним анализом и статусом gate. Все 7 инструментов работают только на чтение, а токен определяет, какие проекты видит ИИ.

Проекты и ветки: инструменты принимают ключ проекта (например, payments-api или my-org_payments-api в Cloud), а не отображаемое имя. Без branch или pullRequest они читают основную ветку. Community Build анализирует только основную ветку.

Частная сеть: если AnythingMCP развёрнут у тебя самостоятельно, а SonarQube Server находится на внутреннем хосте или по приватному IP, этот хост нужно добавить в SSRF_ALLOWED_HOSTS, иначе защита от исходящих запросов отклонит вызов. AnythingMCP Cloud может обращаться только к SonarQube Cloud или к SonarQube Server, доступному из публичного интернета.

Ограничения: инструменты со списками возвращают до 500 элементов на страницу (1000 для sonarqube_get_measures_history). Поиск проблем возвращает не более 10 000 результатов в сумме, поэтому сужай фильтры вместо того, чтобы листать дальше. SonarQube Cloud отвечает 429, если токен отправляет слишком много запросов: подожди несколько минут и повтори попытку. В SonarQube Server по умолчанию ограничения частоты запросов нет.

Частые ошибки: 401 означает, что токен неверный, просрочен или отозван либо это токен анализа, а не пользовательский токен. 403 означает, что у пользователя токена нет права Browse на проект. 404 означает, что ключ проекта, ветка или pull request не существует либо SONARQUBE_URL указан неверно. 400 указывает на отсутствующий или недопустимый параметр, например на отсутствие организации в Cloud.

Коннектор ничего не изменяет в SonarQube (никаких переходов статусов проблем, назначений и комментариев, никаких изменений quality gate, quality profile, проектов и токенов) и не охватывает security hotspots, портфолио и приложения, Web API v2, административные и системные эндпоинты, а также фильтры проблем только по новому коду.

Требования: SONARQUBE_URL, SONARQUBE_TOKEN

Установка коннектора локально

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Открой http://localhost:3000/connectors/store, выбери SonarQube и вставь переменные окружения, перечисленные в разделе «Требования».

Доступные инструменты

Дальнейшие шаги

• Подключение к Claude
• Подключение к ChatGPT