SonarQube MCPサーバーで品質ゲートとissueを確認

💡 インストール不要で使うには、cloud.anythingmcp.com を直接ご利用ください。 サインインして Connectors → SonarQube をクリックし、認証情報を貼り付けて MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要です。

SonarQube

AI に SonarQube を読み取らせましょう。プロジェクト、クオリティゲートのステータス、カバレッジなどのメジャーとその履歴、重大度およびソフトウェア品質別の未解決の issue、解析とブランチを取得できます。SonarQube Server と SonarQube Cloud の両方に対応し、ユーザートークンによる読み取り専用です。

セットアップ

セットアップには約 3 分かかります。SonarQube Server(無料の Community Build でも動作します)または SonarQube Cloud のアカウントで、解析済みのプロジェクトが少なくとも 1 つあること、そしてユーザートークンが必要です。

1. SONARQUBE_URL を、/api と末尾のスラッシュを付けずに設定します。EU リージョンの SonarQube Cloud なら https://sonarcloud.io、US リージョンの SonarQube Cloud なら https://sonarqube.us、SonarQube Server の場合はブラウザで開くときのアドレスをコンテキストパスも含めて指定します(例: https://sonar.example.com や https://example.com/sonarqube)。
2. ユーザートークンを作成し、Bearer という語を付けずに SONARQUBE_TOKEN に貼り付けます。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 ではプロジェクトの一覧取得と issue の検索に必要です。Server では空のままにします。
4. コネクターをインストールして sonarqube_list_projects を実行します。トークンで閲覧できるプロジェクトの一覧と、他のツールが受け取るプロジェクトキーが表示されます。

読み取れる内容: プロジェクトがクオリティゲートに合格したかどうか(OK または ERROR、不合格の各条件を含む)、coverage、duplicated_lines_density、ncloc、software_quality_* の issue 数などの現在のメジャー、解析ごとのメジャーの変化、ソフトウェア品質(SECURITY、RELIABILITY、MAINTAINABILITY)・重大度・ステータスで絞り込んだ issue、イベント付きのプロジェクトの解析、最終解析とゲートのステータス付きのブランチです。7 つのツールはすべて読み取り専用で、AI が参照できるプロジェクトはトークンによって決まります。

プロジェクトとブランチ: ツールが受け取るのは表示名ではなくプロジェクトキーです(例: payments-api、Cloud では my-org_payments-api)。branch や pullRequest を指定しない場合はメインブランチを読み取ります。Community Build ではメインブランチのみが解析されます。

プライベートネットワーク: セルフホストの AnythingMCP から、内部ホストやプライベート IP 上の SonarQube Server に接続するには、そのホストを SSRF_ALLOWED_HOSTS に追加する必要があります。追加しないと、送信ガードが呼び出しを拒否します。AnythingMCP Cloud から接続できるのは、SonarQube Cloud、またはパブリックインターネットから到達可能な SonarQube Server のみです。

制限: 一覧取得ツールは 1 ページあたり最大 500 件を返します(sonarqube_get_measures_history は 1,000 件)。issue 検索で返るのは合計で最大 10,000 件のため、ページを進め続けるのではなく、フィルターを絞り込んでください。SonarQube Cloud は、トークンからのリクエストが多すぎると 429 を返します。数分待ってから再試行してください。SonarQube Server には、デフォルトではレート制限がありません。

よくあるエラー: 401 は、トークンが間違っている、期限切れまたは失効している、あるいはユーザートークンではなく解析トークンであることを意味します。403 は、トークンのユーザーがプロジェクトに対する Browse 権限を持っていないことを意味します。404 は、プロジェクトキー、ブランチ、プルリクエストが存在しないか、SONARQUBE_URL が間違っていることを意味します。400 では、不足している、または無効なパラメーターが示されます(例: Cloud で組織が指定されていない場合)。

このコネクターは SonarQube に対して一切変更を加えません(issue の遷移、担当者の割り当て、コメント、クオリティゲート・クオリティプロファイル・プロジェクト・トークンの変更はできません)。また、セキュリティホットスポット、ポートフォリオとアプリケーション、Web API v2、管理およびシステムのエンドポイント、新規コードのみを対象とした issue フィルターには対応していません。

前提条件: 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 に接続する