SonarQube

🔒 重要：您的 SonarQube 權杖是敏感憑證。請遵循以下安全實務：

使用 CLI 指令時：

• 避免在命令列參數中硬編碼權杖 – 它們會被儲存在 shell 歷史記錄中
• 使用環境變數 – 在執行指令前先將權杖設定於環境變數中

使用設定檔時：

• 絕不將權杖提交到版本控制
• 盡可能在設定檔中使用環境變數替換

SonarQube MCP Server 可在 Antigravity MCP Store 中取得。請依照以下指示操作：

1. 開啟 Agent Side Panel
2. 點擊右上角的三個點（...），然後選擇 MCP Servers
3. 搜尋 SonarQube 並選擇 Install
4. 提供所需的 SonarQube 使用者權杖。如果您要連線到 SonarQube Cloud，也可以提供組織金鑰；如果要連線到 SonarQube Server，則提供 SonarQube URL。

若使用 SonarQube Cloud US，請將 URL 設定為 https://sonarqube.us。

或者，您可以透過 mcp_config.json 手動設定伺服器：

• 若要連線到 SonarQube Cloud：

在 Agent Side Panel 中，點擊三個點（...）-> MCP Store -> Manage MCP Servers -> View raw config，然後新增以下內容：

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": ["run", "--init", "--pull=always", "-i", "--rm", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_ORG", "sonarsource/sonarqube-mcp"],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_TOKEN>",
        "SONARQUBE_ORG": "<YOUR_ORG>"
      }
    }
  }
}

若使用 SonarQube Cloud US，請手動將 "SONARQUBE_URL": "https://sonarqube.us" 新增到 env 區段，並將 "-e", "SONARQUBE_URL" 新增到 args 陣列中。

• 若要連線到 SonarQube Server：

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": ["run", "--init", "--pull=always", "-i", "--rm", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_URL", "sonarsource/sonarqube-mcp"],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_USER_TOKEN>",
        "SONARQUBE_URL": "<YOUR_SERVER_URL>"
      }
    }
  }
}

• 若要連線到 SonarQube Cloud：

claude mcp add sonarqube \
  --env SONARQUBE_TOKEN=$SONAR_TOKEN \
  --env SONARQUBE_ORG=$SONAR_ORG \
  -- docker run --init --pull=always -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_ORG sonarsource/sonarqube-mcp

若使用 SonarQube Cloud US，請在指令中新增 --env SONARQUBE_URL=https://sonarqube.us。

• 若要連線到 SonarQube Server：

claude mcp add sonarqube \
  --env SONARQUBE_TOKEN=$SONAR_USER_TOKEN \
  --env SONARQUBE_URL=$SONAR_URL \
  -- docker run --init --pull=always -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_URL sonarsource/sonarqube-mcp

手動編輯位於 ~/.codex/config.toml 的設定檔，並新增以下設定：

• 若要連線到 SonarQube Cloud：

[mcp_servers.sonarqube]
command = "docker"
args = ["run", "--init", "--pull=always", "--rm", "-i", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_ORG", "sonarsource/sonarqube-mcp"]
env = { "SONARQUBE_TOKEN" = "<YOUR_USER_TOKEN>", "SONARQUBE_ORG" = "<YOUR_ORG>" }

若使用 SonarQube Cloud US，請手動將 "SONARQUBE_URL" = "https://sonarqube.us" 新增到 env 區段，並將 "-e", "SONARQUBE_URL" 新增到 args 陣列中。

• 若要連線到 SonarQube Server：

[mcp_servers.sonarqube]
command = "docker"
args = ["run", "--init", "--pull=always", "--rm", "-i", "-e", "SONARQUBE_TOKEN", "-e", "SONARQUBE_URL", "sonarsource/sonarqube-mcp"]
env = { "SONARQUBE_TOKEN" = "<YOUR_TOKEN>", "SONARQUBE_URL" = "<YOUR_SERVER_URL>" }

• 若要連線到 SonarQube Cloud：

若使用 SonarQube Cloud US，請在安裝後於 MCP 設定的 env 區段中手動新增 "SONARQUBE_URL": "https://sonarqube.us"。

• 若要連線到 SonarQube Server：

注意： Gemini CLI 擴充功能已移至 sonarqube-agent-plugins 儲存庫。請從該處安裝。

您可以使用以下指令安裝我們的 MCP 伺服器擴充功能：

gemini extensions install https://github.com/SonarSource/sonarqube-agent-plugins

在啟動 Gemini 之前，您需要設定所需的環境變數：

所需環境變數：

• 若使用 SonarQube Cloud：

  • SONARQUBE_TOKEN - 您的 SonarQube Cloud 權杖
  • SONARQUBE_ORG - 您的組織金鑰
  • SONARQUBE_URL - （選用）若使用 SonarQube Cloud US，請設定為 https://sonarqube.us

• 若使用 SonarQube Server：

  • SONARQUBE_TOKEN - 您的 SonarQube Server 使用者權杖
  • SONARQUBE_URL - 您的 SonarQube Server URL

安裝完成後，擴充功能會安裝在 <home>/.gemini/extensions/sonarqube/gemini-extension.json 下。

啟動 Copilot CLI 後，執行以下指令以新增 SonarQube MCP 伺服器：

/mcp add

您需要提供關於 MCP 伺服器的不同資訊，可以使用 Tab 鍵在欄位之間導覽。

• 若要連線到 SonarQube Cloud：

Server Name: sonarqube
Server Type: Local (Press 1)
Command: docker
Arguments: run, --init, --pull=always, --rm, -i, -e, SONARQUBE_TOKEN, -e, SONARQUBE_ORG, sonarsource/sonarqube-mcp
Environment Variables: SONARQUBE_TOKEN=<YOUR_TOKEN>,SONARQUBE_ORG=<YOUR_ORG>
Tools: *

若使用 SonarQube Cloud US，請在 Arguments 中新增 -e, SONARQUBE_URL，並在 Environment Variables 中新增 SONARQUBE_URL=https://sonarqube.us。

• 若要連線到 SonarQube Server：

Server Name: sonarqube
Server Type: Local (Press 1)
Command: docker
Arguments: run, --init, --pull=always, --rm, -i, -e, SONARQUBE_TOKEN, -e, SONARQUBE_URL, sonarsource/sonarqube-mcp
Environment Variables: SONARQUBE_TOKEN=<YOUR_USER_TOKEN>,SONARQUBE_URL=<YOUR_SERVER_URL>
Tools: *

設定檔位於 ~/.copilot/mcp-config.json。

GitHub Copilot coding agent 可以直接在您的 CI/CD 中使用 SonarQube MCP 伺服器。

若要將密鑰新增到您的 Copilot 環境，請遵循 Copilot 文件。只有名稱以 COPILOT_MCP_ 為前綴的密鑰才會提供給您的 MCP 設定使用。

在您的 GitHub 儲存庫中，前往 Settings -> Copilot -> Coding agent，並在 MCP 設定區段中新增以下設定：

• 若要連線到 SonarQube Cloud：

{
  "mcpServers": {
    "sonarqube": {
      "type": "local",
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "--rm",
        "-i",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "COPILOT_MCP_SONARQUBE_TOKEN",
        "SONARQUBE_ORG": "COPILOT_MCP_SONARQUBE_ORG"
      },
      "tools": ["*"]
    }
  }
}

若使用 SonarQube Cloud US，請將 "-e", "SONARQUBE_URL" 新增到 args 陣列，將 "SONARQUBE_URL": "COPILOT_MCP_SONARQUBE_URL" 新增到 env 區段，然後設定密鑰 COPILOT_MCP_SONARQUBE_URL=https://sonarqube.us。

• 若要連線到 SonarQube Server：

{
  "mcpServers": {
    "sonarqube": {
      "type": "local",
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "--rm",
        "-i",
        "-e",
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_URL",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "COPILOT_MCP_SONARQUBE_USER_TOKEN",
        "SONARQUBE_URL": "COPILOT_MCP_SONARQUBE_URL"
      },
      "tools": ["*"]
    }
  }
}

在您的工作目錄中建立 .kiro/settings/mcp.json 檔案（如果已存在則編輯），並新增以下設定：

• 若要連線到 SonarQube Cloud：

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e", 
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_ORG",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_TOKEN>",
        "SONARQUBE_ORG": "<YOUR_ORG>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

若使用 SonarQube Cloud US，請將 "-e", "SONARQUBE_URL" 新增到 args 陣列，並將 "SONARQUBE_URL": "https://sonarqube.us" 新增到 env 區段。

• 若要連線到 SonarQube Server：

{
  "mcpServers": {
    "sonarqube": {
      "command": "docker",
      "args": [
        "run",
        "--init",
        "--pull=always",
        "-i",
        "--rm",
        "-e", 
        "SONARQUBE_TOKEN",
        "-e",
        "SONARQUBE_URL",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_TOKEN": "<YOUR_USER_TOKEN>",
        "SONARQUBE_URL": "<YOUR_SERVER_URL>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

您可以使用以下按鈕來簡化 VS Code 中的安裝流程。

若使用 SonarQube Cloud US，請在安裝後於 MCP 設定的 env 區段中手動新增 "SONARQUBE_URL": "https://sonarqube.us"。

SonarQube MCP Server 可作為 Windsurf 外掛程式使用。請依照以下指示操作：

1. 開啟 Windsurf Settings > Cascade > MCP Servers，然後選擇 Open MCP Marketplace
2. 在 Cascade MCP Marketplace 中搜尋 sonarqube
3. 選擇 SonarQube MCP Server 並選擇 Install
4. 新增所需的 SonarQube 使用者權杖。如果您要連線到 SonarQube Cloud，請新增組織金鑰；如果要連線到 SonarQube Server 或 Community Build，請新增 SonarQube URL。

若使用 SonarQube Cloud US，請將 URL 設定為 https://sonarqube.us。

在 Zed 中前往 Extensions 檢視，搜尋 SonarQube MCP Server。 安裝擴充功能時，系統會提示您提供必要的環境變數：

• 若使用 SonarQube Cloud：

{
  "sonarqube_token": "YOUR_SONARQUBE_TOKEN",
  "sonarqube_org": "SONARQUBE_ORGANIZATION_KEY",
  "docker_path": "DOCKER_PATH"
}

若使用 SonarQube Cloud US，請在設定中新增 "sonarqube_url": "https://sonarqube.us"。

• 若使用 SonarQube Server：

{
  "sonarqube_token": "YOUR_SONARQUBE_USER_TOKEN",
  "sonarqube_url": "YOUR_SONARQUBE_SERVER_URL",
  "docker_path": "DOCKER_PATH"
}

docker_path 是 docker 可執行檔的路徑。範例：

Linux/macOS：/usr/bin/docker 或 /usr/local/bin/docker

Windows：C:\Program Files\Docker\Docker\resources\bin\docker.exe

使用 SonarQube for IDE 時，應將 SONARQUBE_IDE_PORT 環境變數設定為正確的連接埠號碼。SonarQube for VS Code 包含 Quick Install 按鈕，可自動設定正確的連接埠設定。

例如，使用 SonarQube Cloud 時：

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run",
      "--init",
      "--pull=always",
      "-i",
      "--rm",
      "-e",
      "SONARQUBE_TOKEN",
      "-e",
      "SONARQUBE_ORG",
      "-e",
      "SONARQUBE_IDE_PORT",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_ORG": "<org>",
      "SONARQUBE_IDE_PORT": "<64120-64130>"
    }
  }
}

在 Linux 上的容器中執行 MCP 伺服器時，容器無法存取在 localhost 上執行的 SonarQube for IDE 內嵌伺服器。若要允許容器連線到 SonarQube for IDE 伺服器，請在容器執行指令中新增 --network=host 選項。

範例

啟用分析、問題和品質閘門工具集（使用 Docker 搭配 SonarQube Cloud）：

docker run --init --pull=always -i --rm \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_ORG="<org>" \
  -e SONARQUBE_TOOLSETS="analysis,issues,quality-gates" \
  sonarsource/sonarqube-mcp

注意：projects 工具集始終自動啟用，因此您不需要將其包含在 SONARQUBE_TOOLSETS 中。

啟用唯讀模式（使用 Docker 搭配 SonarQube Cloud）：

docker run --init --pull=always -i --rm \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_ORG="<org>" \
  -e SONARQUBE_READ_ONLY="true" \
  sonarsource/sonarqube-mcp

使用磁碟區掛載

執行容器時掛載包含憑證的目錄：

docker run --init --pull=always -i --rm \
  -v /path/to/your/certificates/:/usr/local/share/ca-certificates/:ro \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_URL="<url>" \
  sonarsource/sonarqube-mcp

支援的憑證格式

容器支援以下憑證格式：

• .crt 檔案（PEM 或 DER 編碼）
• .pem 檔案（PEM 編碼）

搭配憑證的 MCP 設定

使用自訂憑證時，您可以修改 MCP 設定以掛載憑證：

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run",
      "--init",
      "--pull=always",
      "-i",
      "--rm",
      "-v",
      "/path/to/your/certificates/:/usr/local/share/ca-certificates/:ro",
      "-e",
      "SONARQUBE_TOKEN",
      "-e",
      "SONARQUBE_URL",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

注意： 不是使用容器而是從 JAR 執行伺服器嗎？上述磁碟區掛載會將憑證安裝到容器的作業系統信任庫中，伺服器也會讀取該信任庫。如果您無法使用作業系統信任庫——特別是在 Windows 上，系統不會查詢該信任庫——請將 JVM 指向包含 CA 憑證的 Java 信任庫：-Djavax.net.ssl.trustStore=/path/to/truststore.p12 -Djavax.net.ssl.trustStoreType=PKCS12 -Djavax.net.ssl.trustStorePassword=<passphrase>。它會附加在預設受信任憑證之上。

HTTP/HTTPS Proxy

您可以使用 Java 系統屬性設定 proxy。這些屬性可以設定為環境變數或作為 JVM 引數傳遞。

常見 Proxy 屬性：

HTTP/HTTPS Proxy 驗證：

SOCKS5 Proxy

支援 SOCKS5 proxy。

使用 PKCS12 金鑰庫

將您的 .p12 或 .pfx 檔案掛載至容器中，並使用金鑰庫屬性設定 JAVA_OPTS 環境變數：

docker run --init --pull=always -i --rm \
  -v /path/to/client.p12:/etc/ssl/mcp/client.p12:ro \
  -e JAVA_OPTS="-Djavax.net.ssl.keyStore=/etc/ssl/mcp/client.p12 -Djavax.net.ssl.keyStoreType=PKCS12 -Djavax.net.ssl.keyStorePassword=<passphrase>" \
  -e SONARQUBE_TOKEN="<token>" \
  -e SONARQUBE_URL="<url>" \
  sonarsource/sonarqube-mcp

注意： 憑證檔案必須可被容器程序讀取。如有需要，請檢查並修正權限：

ls -la /path/to/client.p12       # 查看是否為 -rw-r--r-- (644) 或更寬鬆的權限
chmod 644 /path/to/client.p12    # 授予容器使用者讀取權限

如果金鑰庫沒有密碼短語，請省略 -Djavax.net.ssl.keyStorePassword。請注意，此處使用的密碼短語可能會透過 docker inspect 或程序列表被看到。

使用用戶端憑證的 MCP 組態

{
  "sonarqube": {
    "command": "docker",
    "args": [
      "run", "--init", "--pull=always", "-i", "--rm",
      "-v", "/path/to/client.p12:/etc/ssl/mcp/client.p12:ro",
      "-e", "JAVA_OPTS",
      "-e", "SONARQUBE_TOKEN",
      "-e", "SONARQUBE_URL",
      "sonarsource/sonarqube-mcp"
    ],
    "env": {
      "JAVA_OPTS": "-Djavax.net.ssl.keyStore=/etc/ssl/mcp/client.p12 -Djavax.net.ssl.keyStoreType=PKCS12 -Djavax.net.ssl.keyStorePassword=<passphrase>",
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

使用 PKCS12 金鑰庫搭配獨立 JAR

當從 JAR 執行伺服器時，請在 -jar 之前以 JVM 引數傳遞金鑰庫屬性：

java \
  -Djavax.net.ssl.keyStore=/path/to/client.p12 \
  -Djavax.net.ssl.keyStoreType=PKCS12 \
  -Djavax.net.ssl.keyStorePassword=<passphrase> \
  -jar <path_to_sonarqube_mcp_server_jar>

如果金鑰庫沒有密碼短語，請省略 -Djavax.net.ssl.keyStorePassword。

使用用戶端憑證的 MCP 組態（JAR）

{
  "sonarqube": {
    "command": "java",
    "args": [
      "-Djavax.net.ssl.keyStore=/path/to/client.p12",
      "-Djavax.net.ssl.keyStoreType=PKCS12",
      "-Djavax.net.ssl.keyStorePassword=<passphrase>",
      "-jar",
      "<path_to_sonarqube_mcp_server_jar>"
    ],
    "env": {
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

注意： PEM 憑證和金鑰檔案（分開的 .crt/.key 檔案）必須先轉換為 PKCS12 格式。請使用 openssl pkcs12 -export -in client.crt -inkey client.key -out client.p12 進行轉換。

• search_by_signature_patterns - 使用正規表示式模式，依宣告簽名尋找程式碼元素（類別、方法、介面等）。

  • include_code_regex_list - 要與簽名比對的正規表示式模式列表 - 必填字串[]
  • exclude_code_regex_list - 要從結果中排除的正規表示式模式列表 - 字串[]
  • include_glob - 檔案篩選 glob 模式（例如 *.java） - 字串
  • exclude_glob - 檔案排除 glob 模式 - 字串
  • fields - 以逗號分隔的回應中包含的欄位列表 - 字串
  • limit - 要回傳的最大結果數（預設：10） - 整數
  • regex_lists_operator - 如何組合多個模式：OR（預設）或 AND - 字串

• search_by_body_patterns - 使用正規表示式模式，依實作主體尋找程式碼元素。對於定位 API 或模式實際使用的位置很有用。

  • include_code_regex_list - 要在程式碼主體中比對的正規表示式模式列表 - 必填字串[]
  • exclude_code_regex_list - 要從結果中排除的正規表示式模式列表 - 字串[]
  • include_glob - 檔案篩選 glob 模式 - 字串
  • exclude_glob - 檔案排除 glob 模式 - 字串
  • fields - 以逗號分隔的回應中包含的欄位列表 - 字串
  • limit - 要回傳的最大結果數（預設：10） - 整數
  • regex_lists_operator - 如何組合多個模式：OR（預設）或 AND - 字串

• get_upstream_call_flow - 追蹤哪些函式呼叫了給定的函式。對於尋找所有呼叫者和進入點，以及了解簽名變更時會破壞什麼很有用。

  • fqn - 函式的完整限定名稱 - 必填字串
  • depth - 呼叫鏈深度（0=僅函式，1=直接呼叫者，依此類推） - 整數
  • fields - 以逗號分隔的回應中包含的欄位列表 - 字串

• get_downstream_call_flow - 追蹤給定函式呼叫了哪些函式。對於影響分析和了解執行流程很有用。

  • fqn - 函式的完整限定名稱 - 必填字串
  • depth - 呼叫鏈深度（0=僅函式，1=直接被呼叫者，依此類推） - 整數
  • fields - 以逗號分隔的回應中包含的欄位列表 - 字串

• get_source_code - 依完整限定名稱取得程式碼元素的完整原始碼（簽名和主體）。

  • fqn - 元素的完整限定名稱 - 必填字串
  • fields - 以逗號分隔的回應中包含的欄位列表 - 字串

• get_type_hierarchy - 取得類別結構（類別、介面、列舉、記錄、例外、結構）的完整繼承階層。對於理解繼承樹和重構至關重要。

  • fqn - 類別結構的完整限定名稱 - 必填字串
  • fields - 要包含在回應中的欄位清單（以逗號分隔） - 字串

• get_references - 取得類別或模組的直接傳入和傳出程式碼參考。僅回傳直接（非傳遞性）參考。

  • fqn - 類別或模組的完整限定名稱 - 必填字串
  • fields - 要包含在回應中的欄位清單（以逗號分隔） - 字串

• get_current_architecture - 取得依路徑前綴和深度篩選的階層式架構圖。適用於探索模組結構和高層級相依性。

  • depth - 階層深度（0=僅根節點，1=根節點加子節點，以此類推） - 必填整數
  • path_prefix - 可選的路徑前綴以篩選節點（例如，com.example.service） - 字串
  • ecosystem - 可選的生態系統篩選條件（java、cs、py、js、ts） - 字串

• get_intended_architecture - 取得使用者定義的架構約束，指定哪些模組允許依賴其他模組。

• get_guidelines - 根據 SonarQube 專案問題、目錄類別或兩者的組合取得編碼準則。
  • mode - 準則擷取模式：project_based、category_based 或 combined - 必填字串
  • categories - 類別名稱清單（category_based 和 combined 模式需要） - String[]
  • languages - 以 SonarQube 儲存庫金鑰格式表示的目標語言清單（提供 categories 時需要） - String[]
  • file_paths - 可選的檔案路徑清單，用於篩選準則 - String[]

• check_dependency - 在新增或更新第三方相依性之前，檢查其安全性漏洞、供應鏈惡意軟體和授權合規性。
  • purl - 包含版本的套件 URL（purl），依據 purl-spec。格式：pkg:<type>/<namespace>/<name>@<version>（例如 pkg:npm/lodash@4.17.21、pkg:maven/org.apache.logging.log4j/log4j-core@2.14.1、pkg:pypi/django@3.2.0） - 必填字串

• 當不使用 git，或 git 分支名稱與 SonarQube 中的分支名稱不符時提供。

首先，為您的專案匯出帶有有效 個人存取權杖 (PAT) 的 SONARQUBE_TOKEN 環境變數。

# macOS/Linux (Bash/Zsh)
export SONARQUBE_TOKEN="{<YourUserToken>}"

然後，掛載專案工作區，讓情境增強伺服器直接存取您的原始碼檔案：

{
  "mcpServers": {
    "sonarqube-mcp-server": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm", "--pull=always",
        "-e", "SONARQUBE_URL",
        "-e", "SONARQUBE_TOKEN",
        "-e", "SONARQUBE_ORG",
        "-e", "SONARQUBE_PROJECT_KEY",
        "-e", "SONARQUBE_TOOLSETS",
        "-v", "/ABSOLUTE/PATH/TO/YOUR/PROJECT:/app/mcp-workspace:rw",
        "sonarsource/sonarqube-mcp"
      ],
      "env": {
        "SONARQUBE_URL": "https://sonarcloud.io",
        "SONARQUBE_ORG": "<YourOrganizationKey>",
        "SONARQUBE_PROJECT_KEY": "<YourProjectKey>",
        "SONARQUBE_TOOLSETS": "cag"
      }
    }
  }
}

重要：在專案範圍的設定中，請勿將 SONARQUBE_TOKEN 放在 env 區塊中。請將其匯出為環境變數（export SONARQUBE_TOKEN=...）。Docker 會透過 -e SONARQUBE_TOKEN 將其轉發到容器中。

My quality gate is failing for my project. Can you help me understand why and fix the most critical issues?

The quality gate on my feature branch is red. What do I need to fix to get it passing before I can merge to main?

I'm about to merge my pull request <#247> for the <web-app> project. Can you check if there are any quality issues I should address first?

We're deploying to production tomorrow. Can you check the quality gate status and alert me to any critical issues in this branch?

I want to reduce technical debt in my project. What are the top issues I should prioritize?

Our code coverage dropped below 70%. Can you identify which files have the lowest coverage and help me improve it?

I have 15 new code smells in my latest commit. Can you explain what they are and help me fix them?

SonarQube flagged a critical security vulnerability in <AuthController.java>. What's the issue and how do I fix it?

We need to pass a security audit. Can you check all our projects for security vulnerabilities and create a prioritized list of what needs to be fixed?

Are there any known vulnerabilities in our dependencies? Check this project for dependency risks.

I just wrote this authentication function. Can you analyze it for security issues and code quality problems before I commit?

Review the changes in <src/database/migrations> for any potential bugs or security issues.

Give me a health report for my project: quality gate status, number of bugs, Security Hotspots, and code coverage.

Compare code quality between our main branch and the develop branch. Are we introducing new issues?

What are the most common rule violations across all our projects? We might need to update our coding standards.

Show me all the issues that were marked as false positives in the last month. Are we seeing patterns that suggest our rules need adjustment?

從 二進位檔儲存庫 下載您所需版本的 JAR，然後設定您的 MCP 用戶端以使用 Java 21 或更新版本執行：

• 若要連線到 SonarQube Cloud：

{
  "sonarqube": {
    "command": "java",
    "args": [
      "-jar",
      "<path_to_sonarqube_mcp_server_jar>"
    ],
    "env": {
      "STORAGE_PATH": "<path_to_your_mcp_storage>",
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_ORG": "<org>"
    }
  }
}

• 若要連線到 SonarQube Server：

{
  "sonarqube": {
    "command": "java",
    "args": [
      "-jar",
      "<path_to_sonarqube_mcp_server_jar>"
    ],
    "env": {
      "STORAGE_PATH": "<path_to_your_mcp_storage>",
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

SonarQube MCP 伺服器需要 Java Development Kit (JDK) 21 或更新版本才能建置。

執行以下 Gradle 命令來清理專案並建置應用程式：

./gradlew clean build -x test

JAR 檔案將建立在 build/libs/ 中。

新增或更新相依性後，重新產生鎖定檔案：

./gradlew :dependencies --write-locks
./gradlew :its:dependencies --write-locks

使用上述的 從 JAR 執行 設定，將 <path_to_sonarqube_mcp_server_jar> 指向 build/libs/ 中的 JAR。