用途:该技能提供使用 SonarQube MCP Server 工具的说明与模式,让智能体在合并或部署前检查质量门状态、按严重级别与项目发现和分诊问题、在提交前本地分析代码片段(左移),以及查阅 SonarQube 规则文档。
主要能力:get_project_quality_gate_status 检查项目或 PR 的质量门;search_sonar_issues_in_projects 按项目、严重级别(BLOCKER、HIGH、MEDIUM、LOW、INFO)和 PR 搜索问题;analyze_code_snippet 在提交前分析代码片段;show_rule 查看规则详情;get_component_measures 获取覆盖率、缺陷、漏洞、代码异味等指标;change_sonar_issue_status 将问题标记为误报、接受或重新打开。
使用方式:插件内含 .mcp.json,通过 Docker 自动启动 SonarQube MCP Server。需先设置环境变量:SonarQube Server 需 SONARQUBE_TOKEN 与 SONARQUBE_URL(本地 Docker 用 http://host.docker.internal:9000);SonarCloud 需 SONARQUBE_TOKEN 与 SONARQUBE_ORG,无需 SONARQUBE_URL。要求 Docker 已安装并运行。工具名格式为 mcp__sonarqube-mcp__<tool-name>。
适用场景:PR 合并前质量门检查、查找关键或阻断级问题、提交前代码分析、理解规则告警原因、获取提交前质量反馈。
限制:MCP 服务器必须已配置并运行;analyze_code_snippet 为孤立分析,完整项目上下文可能影响 CI 结果;更改问题状态需相应 SonarQube 权限;SonarCloud 与 SonarQube Server API 大体兼容但部分功能有差异;问题较多时需分页(p、ps,ps 最大 500);质量门状态反映最近一次完成的分析,代码变更后需重新触发分析;不得在未经用户明确确认时自动更改问题状态。