SonarQube

SonarQube MCP Server

SonarQube MCP Server เป็นเซิร์ฟเวอร์ Model Context Protocol (MCP) ที่ช่วยให้ผสานการทำงานกับ SonarQube Server หรือ Cloud ได้อย่างราบรื่น เพื่อยกระดับคุณภาพและความปลอดภัยของโค้ด นอกจากนี้ยังรองรับการวิเคราะห์โค้ดตัวอย่างภายในบริบทของเอเจนต์โดยตรง

เริ่มต้นด้วยการตั้งค่าอย่างรวดเร็ว หรือเรียนรู้เพิ่มเติมเกี่ยวกับกลุ่มผลิตภัณฑ์ SonarQube

การตั้งค่าอย่างรวดเร็ว

🚀 สร้างการกำหนดค่าของคุณ

วิธีเริ่มต้นที่เร็วที่สุดคือใช้ เครื่องมือสร้างการกำหนดค่า SonarQube MCP Server ซึ่งเป็นเครื่องมือแบบโต้ตอบที่สร้างการกำหนดค่าพร้อมใช้งานสำหรับไคลเอ็นต์ AI agent ที่คุณเลือก

ตั้งค่าด้วยตนเอง

หากต้องการกำหนดค่าด้วยตนเอง วิธีที่ง่ายที่สุดคือใช้ container image ของเราที่ sonarsource/sonarqube-mcp ใช้ sonarsource/sonarqube-mcp เพื่ออัปเดตโดยอัตโนมัติ (ด้วย --pull=always) หรือระบุแท็กเวอร์ชัน (เช่น sonarsource/sonarqube-mcp:1.19.0.2785) เพื่อให้การติดตั้งใช้งานทำซ้ำได้ บางรุ่นยังติดแท็กด้วยเวอร์ชัน SonarQube Server ที่สอดคล้องกันในรูปแบบ <SQS major>.<SQS minor>.<patch> (เช่น sonarsource/sonarqube-mcp:2026.5.0) โดยเพิ่มหมายเลขแพตช์สำหรับ MCP แต่ละรุ่นที่กำหนดเป้าหมายไปยัง SonarQube Server เวอร์ชันนั้น อ่านรายละเอียดด้านล่างหากต้องการสร้างในเครื่อง

หมายเหตุ: แม้ตัวอย่างด้านล่างจะใช้ docker แต่สามารถใช้ runtime ของ container ที่เข้ากันได้กับ OCI ได้ (เช่น Podman, nerdctl) เพียงแทนที่ docker ด้วยเครื่องมือที่คุณต้องการ

{
  "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>"
      }
    }
  }
}

{
  "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>"
      }
    }
  }
}

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

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

[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>" }

[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>" }

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

/mcp add

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: *

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: *

{
  "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": ["*"]
    }
  }
}

{
  "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": ["*"]
    }
  }
}

{
  "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": []
    }
  }
}

{
  "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": []
    }
  }
}

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

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

💡 เคล็ดลับ: เราแนะนำให้ดึง image ล่าสุดเป็นประจำหรือก่อนรายงานปัญหา เพื่อให้แน่ใจว่าคุณมีฟีเจอร์และการแก้ไขล่าสุด

การติดตั้งด้วยตนเอง

คุณสามารถติดตั้ง SonarQube MCP server ด้วยตนเองได้โดยคัดลอก snippet ต่อไปนี้ลงในไฟล์การกำหนดค่า MCP servers:

• เชื่อมต่อกับ SonarQube Cloud:

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

• เชื่อมต่อกับ SonarQube Server:

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

การผสานรวมกับ SonarQube for IDE

SonarQube MCP Server สามารถผสานรวมกับ SonarQube for IDE เพื่อยกระดับเวิร์กโฟลว์การพัฒนาของคุณ พร้อมมอบการวิเคราะห์โค้ดและข้อมูลเชิงลึกที่ดียิ่งขึ้นภายใน IDE โดยตรง

{
  "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>"
    }
  }
}

การกำหนดค่า

คุณควรกำหนดตัวแปรสภาพแวดล้อมเฉพาะตามสภาพแวดล้อมของคุณ

พื้นฐาน

คุณควรเพิ่มตัวแปรต่อไปนี้เมื่อเรียกใช้ MCP Server:

การเมานต์ Workspace (ลดบริบทที่มากเกินไป)

โดยค่าเริ่มต้น เครื่องมือวิเคราะห์ analyze_code_snippet กำหนดให้เอเจนต์ส่งเนื้อหาไฟล์ทั้งหมดเป็นอาร์กิวเมนต์ fileContent สำหรับไฟล์ขนาดใหญ่หรือเมื่อวิเคราะห์ไฟล์จำนวนมากในเซสชัน การดำเนินการนี้จะเพิ่มการใช้หน้าต่างบริบทและค่าใช้จ่ายอย่างมาก

วิธีแก้: เมานต์ไดเรกทอรีโปรเจกต์ของคุณเข้าในคอนเทนเนอร์ที่ /app/mcp-workspace เมื่อตรวจพบการเมานต์นี้ เซิร์ฟเวอร์จะอ่านไฟล์จากดิสก์โดยตรงโดยใช้อาร์กิวเมนต์ filePath ที่สัมพันธ์กับโปรเจกต์ — เนื้อหาไฟล์จะไม่ผ่านบริบทของเอเจนต์

{
  "args": [
    "run", "-i", "--rm", "--init", "--pull=always",
    "-e", "SONARQUBE_TOKEN",
    "-e", "SONARQUBE_ORG",
    "-v", "/path/to/your/project:/app/mcp-workspace",
    "sonarsource/sonarqube-mcp"
  ]
}

เมื่อมีการเมานต์ เครื่องมือวิเคราะห์จะอ่านไฟล์โดยตรงโดยใช้ filePath; ไม่จำเป็นต้องใช้ fileContent

ผ่าน stdio ระบบจะเลือกการวิเคราะห์เมื่อเริ่มต้น (ขึ้นอยู่กับชุดเครื่องมือที่เปิดใช้):

• SonarQube Cloud: การวิเคราะห์ Vortex (run_advanced_code_analysis) เมื่อมีการเมานต์ workspace และมีองค์กรที่มีสิทธิ์ใช้งานอย่างน้อยหนึ่งองค์กร มิฉะนั้นจะใช้การวิเคราะห์ในเครื่อง การวิเคราะห์ Vortex รองรับเฉพาะองค์กรที่มีสิทธิ์ใช้งานเท่านั้น
• SonarQube Server: การวิเคราะห์ Vortex สำหรับอินสแตนซ์ที่มีสิทธิ์ใช้งาน (ต้องมีการเมานต์ workspace); การวิเคราะห์ในเครื่องสำหรับอินสแตนซ์ที่ไม่มี Vortex

การวิเคราะห์ในเครื่องจะใช้ SonarQube for IDE หากเชื่อมต่ออยู่ หรือ analyze_code_snippet หากไม่มีการเมานต์ การวิเคราะห์ snippet ต้องใช้ fileContent

บน Cloud stdio, SONARQUBE_ORG จะจำกัดการตรวจสอบสิทธิ์ใช้งานไว้เฉพาะองค์กรนั้น หากต้องการใช้ snippet กับทุกองค์กร ให้ตั้งค่า SONARQUBE_FORCE_LOCAL_ANALYSIS=true เปิดใช้ชุดเครื่องมือ analysis แล้วเริ่มระบบใหม่ การตั้งค่านี้มีผลกับ Cloud stdio เท่านั้น

ผ่าน HTTP/HTTPS, Cloud และ Server รองรับ analyze_code_snippet เมื่อเซิร์ฟเวอร์ MCP มี SONARQUBE_TOKEN สำหรับการเริ่มต้น และเปิดใช้ชุดเครื่องมือ analysis ต้องใช้โทเค็นเริ่มต้นเพื่อเริ่มต้นตัววิเคราะห์ (การดาวน์โหลดปลั๊กอิน Cloud เป็นแบบไม่ระบุตัวตน); การเรียกใช้จะใช้โทเค็นของผู้เรียก และบน Cloud จะใช้องค์กรที่เลือกสำหรับคำขอเพื่อดึงโปรไฟล์คุณภาพและกฎที่ใช้งานอยู่ หากไม่มีโทเค็นเริ่มต้น การวิเคราะห์ snippet และการดาวน์โหลดตัววิเคราะห์จะถูกปิดใช้งาน แม้จะมี SONARQUBE_FORCE_LOCAL_ANALYSIS=true ก็ไม่มีข้อยกเว้น ไม่จำเป็นต้องมีสิทธิ์ Vortex

การเปิดใช้เครื่องมือแบบเลือกได้

ไคลเอ็นต์ MCP จะโหลดเครื่องมือที่เปิดใช้ทั้งหมด — ชื่อ คำอธิบาย และสคีมาอินพุต — เข้าสู่บริบทของเอเจนต์ในทุกการสนทนา การจำกัดรายการดังกล่าวด้วย SONARQUBE_TOOLSETS จะช่วยลดการใช้บริบทและค่าใช้จ่ายโทเค็นของแต่ละเซสชัน

โดยค่าเริ่มต้น จะเปิดใช้เฉพาะชุดเครื่องมือที่สำคัญ เปิดใช้ชุดเครื่องมือเพิ่มเติมเฉพาะเมื่อจำเป็น

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

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

SonarQube Cloud

สำหรับ stdio ให้กำหนดค่าตัวแปรสภาพแวดล้อมต่อไปนี้:

ตัวอย่าง:

• SonarQube Cloud: ต้องใช้เพียง SONARQUBE_TOKEN เท่านั้น SONARQUBE_ORG จะกำหนดองค์กรตายตัวเมื่อมีการตั้งค่า
• SonarQube Cloud US: ตั้งค่า SONARQUBE_TOKEN และ SONARQUBE_URL=https://sonarqube.us; SONARQUBE_ORG เป็นตัวเลือก

SonarQube Server

ข้อกำหนดด้านเวอร์ชัน: ต้องใช้ SonarQube Server 2025.1 (SQS) หรือ 25.1 (SonarQube Community Build) ขึ้นไป เมื่อเริ่มต้น เซิร์ฟเวอร์ MCP จะอ่านเวอร์ชันของอินสแตนซ์ที่เชื่อมต่อ และออกจากการทำงานพร้อมข้อผิดพลาดหากเวอร์ชันเก่าเกินไป (ตัวอย่างเช่น Server รุ่นเก่า 9.x/10.x และ Community Build 24.x ไม่รองรับ) SonarQube Cloud ไม่อยู่ภายใต้การตรวจสอบนี้

⚠️ การเชื่อมต่อกับ SonarQube Server ต้องใช้โทเค็นประเภท USER และจะทำงานไม่ถูกต้องหากใช้โทเค็นโปรเจกต์หรือโทเค็นส่วนกลาง

💡 เคล็ดลับการกำหนดค่า (โหมด stdio): หากไม่มี URL โทเค็นจะใช้ SonarQube Cloud เป็นค่าเริ่มต้น ตั้งค่า SONARQUBE_URL สำหรับ SonarQube Server หรือ Cloud ภูมิภาคอื่น SONARQUBE_ORG จะกำหนดองค์กร Cloud ตายตัวเมื่อมีการตั้งค่า

ใน stdio การตั้งค่า SONARQUBE_ORG จะกำหนดองค์กร Cloud ตายตัว อาร์กิวเมนต์ organization ของเครื่องมือจะถูกตัดออกจากสคีมาและถูกปฏิเสธ เช่นเดียวกับ projectKey เมื่อกำหนด SONARQUBE_PROJECT_KEY

เมื่อไม่ได้กำหนด SONARQUBE_ORG เอเจนต์สามารถเรียก list_organizations เพื่อค้นหาคีย์ ชื่อ ID และ UUID ขององค์กรที่บัญชีผู้ใช้ของคุณเข้าถึงได้ จากนั้นส่งคีย์เป็นอาร์กิวเมนต์ organization ซึ่งเป็นตัวเลือกให้กับเครื่องมือที่รองรับองค์กร stdio จะคงองค์กรที่ตรวจพบได้เพียงแห่งเดียวไว้เป็นค่าเริ่มต้น หากไม่พบองค์กรหรือพบหลายองค์กร ระบบจะไม่ระบุองค์กร อาร์กิวเมนต์ของเครื่องมือมีผลเฉพาะการเรียกครั้งนั้น และจะไม่เปลี่ยนค่าเริ่มต้นที่ตรวจพบ การค้นหาโปรไฟล์ข้อมูลโค้ดและกฎจะใช้องค์กรที่เลือกสำหรับการเรียกครั้งนั้น

สำหรับคำขอโทเค็นผ่าน HTTP/HTTPS ยังคงรองรับ SONARQUBE_ORG ระดับเซิร์ฟเวอร์เพื่อความเข้ากันได้ แต่เลิกแนะนำให้ใช้แล้วและจะบันทึกคำเตือนเมื่อเริ่มต้น โดยจะกำหนดองค์กรตายตัวสำหรับทุกคำขอ และปฏิเสธส่วนหัวองค์กรจากไคลเอ็นต์และอาร์กิวเมนต์ organization ของเครื่องมือ เมื่อไม่ได้กำหนดองค์กรระดับเซิร์ฟเวอร์ ส่วนหัว SONARQUBE_ORG จากไคลเอ็นต์ซึ่งเป็นตัวเลือกจะกำหนดองค์กรตายตัวสำหรับคำขอนั้น และไม่อนุญาตให้อาร์กิวเมนต์ organization ของเครื่องมือใช้งาน หากไม่มีส่วนหัว ให้ใช้อาร์กิวเมนต์ของเครื่องมือ เครื่องมือที่ต้องใช้องค์กรจะแสดงคำแนะนำในการค้นหาเมื่อไม่มีการระบุข้อมูลทั้งหมด การค้นหาองค์กรและเครื่องมือที่ API ใช้เฉพาะตัวระบุทรัพยากรไม่จำเป็นต้องมีอาร์กิวเมนต์องค์กร การค้นหาปัญหาที่รองรับองค์กรและการตรวจสอบสิทธิ์ Dependency Risks จะใช้องค์กรที่เลือก เมื่อกำหนดค่า OAuth ระบบจะปฏิเสธ SONARQUBE_ORG ระดับเซิร์ฟเวอร์ คำขอ OAuth จะปฏิเสธส่วนหัวองค์กรด้วย ให้เลือกองค์กรผ่านอาร์กิวเมนต์ของเครื่องมือ

เครื่องมือบริบท Vortex ใช้องค์กรที่กำหนดค่าไว้หรือองค์กรที่ตรวจพบได้เพียงแห่งเดียวเมื่อเริ่มต้น อาร์กิวเมนต์องค์กรขณะรันไทม์จะไม่กำหนดค่าเอนจินบริบทที่พร็อกซีส่งต่อไปใหม่ หากไม่สามารถระบุองค์กรตอนเริ่มต้นได้ ระบบจะข้ามพร็อกซีนั้น เครื่องมือ run_advanced_code_analysis ที่มีมาให้จะตรวจสอบสิทธิ์ใช้งาน Vortex แบบรวมสำหรับองค์กรที่เลือกในการเรียกแต่ละครั้ง

โหมดการรับส่ง

ข้อกำหนด MCP กำหนดกลไกการรับส่งข้อมูลไว้สองแบบ ได้แก่ Stdio และ Streamable HTTP เซิร์ฟเวอร์ MCP ของ SonarQube รองรับทั้งสองแบบ:

หมายเหตุ: Streamable HTTP เป็นการรับส่งข้อมูลผ่านเครือข่ายของ MCP ในปัจจุบัน การรับส่งข้อมูล HTTP แบบ SSE-only รุ่นเก่าจาก MCP เวอร์ชันก่อนหน้าเลิกใช้แล้วและไม่รองรับ

1. Stdio (ค่าเริ่มต้น - แนะนำสำหรับการพัฒนาในเครื่อง)

โหมดที่แนะนำสำหรับการพัฒนาในเครื่องและการตั้งค่าแบบผู้ใช้คนเดียว ซึ่งไคลเอ็นต์ MCP ส่วนใหญ่ใช้

ตัวอย่าง - Docker กับ 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>"
      }
    }
  }
}

2. HTTP (Streamable HTTP)

การรับส่งข้อมูล Streamable HTTP ที่ไม่มีการเข้ารหัส สำหรับการติดตั้งใช้งานแบบหลายผู้ใช้ ให้ใช้ HTTPS แทน

⚠️ ไม่แนะนำ: ใช้ Stdio สำหรับการพัฒนาในเครื่อง หรือใช้ HTTPS (Streamable HTTP) สำหรับการติดตั้งใช้งานจริงแบบหลายผู้ใช้

• SONARQUBE_ORG เป็นส่วนหัวคำขอที่ไม่บังคับ ซึ่งกำหนดองค์กรสำหรับคำขอนั้น การกำหนดค่าระดับเซิร์ฟเวอร์ที่เลิกใช้แล้วจะกำหนดองค์กรสำหรับทุกคำขอ และปฏิเสธส่วนหัวองค์กรจากไคลเอ็นต์และอาร์กิวเมนต์องค์กรของเครื่องมือ
• เครื่องมือที่รองรับองค์กรรับอาร์กิวเมนต์ organization ที่ไม่บังคับ เมื่อทั้งการกำหนดค่าเซิร์ฟเวอร์และส่วนหัวคำขอไม่ได้กำหนดองค์กรไว้ หากระบุอาร์กิวเมนต์นี้ในกรณีที่กำหนดองค์กรไว้แล้ว ระบบจะปฏิเสธ
• หากไม่มีค่าเริ่มต้น เอเจนต์สามารถเรียก list_organizations โดยใช้เพียงโทเค็นของตน จากนั้นส่งคีย์ที่เลือกให้เครื่องมือถัดไป

ไคลเอ็นต์ยังสามารถจำกัดเครื่องมือที่มองเห็นได้ในแต่ละคำขอ โดยระบุส่วนหัว SONARQUBE_TOOLSETS และ/หรือ SONARQUBE_READ_ONLY ซึ่งจะกรองเพิ่มเติมจากการกำหนดค่าระดับเซิร์ฟเวอร์ โดยทำได้เพียงลดขอบเขตเท่านั้น ไม่สามารถขยายได้ ไม่มีการเก็บสถานะเซสชันระหว่างคำขอ

เลิกใช้แล้ว: สำหรับโทเค็น SonarQube ยังคงยอมรับส่วนหัวคำขอ SONARQUBE_TOKEN เพื่อความเข้ากันได้แบบย้อนหลัง แต่จะนำออกในเวอร์ชันอนาคต โปรดย้ายไปใช้ Authorization: Bearer <token>

3. HTTPS (Streamable HTTP ผ่าน TLS) (แนะนำสำหรับการติดตั้งใช้งานจริงแบบหลายผู้ใช้)

การขนส่ง Streamable HTTP ที่ปลอดภัยด้วยการเข้ารหัส TLS ต้องใช้ใบรับรอง SSL

✅ แนะนำสำหรับการใช้งานจริง: ใช้ HTTPS เมื่อติดตั้งเซิร์ฟเวอร์ MCP สำหรับผู้ใช้หลายคนผ่าน Streamable HTTP โดยค่าเริ่มต้น เซิร์ฟเวอร์จะผูกกับ 127.0.0.1 (localhost) เพื่อความปลอดภัย

การกำหนดค่าใบรับรอง SSL (ไม่บังคับ):

ตัวอย่าง - Docker กับ SonarQube Cloud:

หมายเหตุ: เมื่อทำงานในคอนเทนเนอร์ ให้ตั้งค่า SONARQUBE_HTTP_HOST=0.0.0.0 เพื่อให้คอนเทนเนอร์รับฟังทุกอินเทอร์เฟซและให้การแมปพอร์ตของ runtime ทำงานได้ และตั้งค่า SONARQUBE_MCP_IN_CONTAINER=true เพื่อแจ้งเซิร์ฟเวอร์ว่ากำลังทำงานภายในคอนเทนเนอร์ อิมเมจ Docker อย่างเป็นทางการจะตั้งค่ารายการหลังให้อัตโนมัติ หากใช้ OCI runtime อื่น (Podman, Kubernetes, Nomad ฯลฯ) ให้ตั้งค่าด้วยตนเอง แฟล็กพอร์ตฝั่งโฮสต์จะควบคุมว่าใครสามารถเข้าถึงเซิร์ฟเวอร์จากภายนอกคอนเทนเนอร์ได้ SONARQUBE_HTTP_HOST=0.0.0.0 ควบคุมเฉพาะตำแหน่งที่เซิร์ฟเวอร์รับฟังภายในคอนเทนเนอร์เท่านั้น โดยค่าเริ่มต้น CORS ของเบราว์เซอร์ยังคงอนุญาตต้นทาง localhost

สำหรับเซิร์ฟเวอร์ที่ทำงาน ภายในเครื่องของคุณ (เข้าถึงได้จาก localhost เท่านั้น):

docker run --init --pull=always -p 127.0.0.1:8443:8443 \
  -v $(pwd)/keystore.p12:/etc/ssl/mcp/keystore.p12:ro \
  -e SONARQUBE_TRANSPORT=https \
  -e SONARQUBE_HTTP_HOST=0.0.0.0 \
  -e SONARQUBE_HTTP_PORT=8443 \
  sonarsource/sonarqube-mcp

สำหรับเซิร์ฟเวอร์ที่ เข้าถึงได้จากเครือข่าย (การติดตั้งใช้งานระยะไกล):

docker run --init --pull=always -p 8443:8443 \
  -v $(pwd)/keystore.p12:/etc/ssl/mcp/keystore.p12:ro \
  -e SONARQUBE_TRANSPORT=https \
  -e SONARQUBE_HTTP_HOST=0.0.0.0 \
  -e SONARQUBE_HTTP_PORT=8443 \
  sonarsource/sonarqube-mcp

การกำหนดค่าไคลเอ็นต์ (SonarQube Cloud):

สำหรับคำขอโทเค็น SonarQube ให้ตั้งค่า SONARQUBE_ORG ในส่วนหัวของไคลเอ็นต์ (ไม่บังคับ) เพื่อกำหนดองค์กรของคำขอ หรือไม่ต้องระบุเพื่อเลือกองค์กรผ่านอาร์กิวเมนต์ของเครื่องมือ

{
  "mcpServers": {
    "sonarqube-https": {
      "url": "https://your-server:8443/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>",
        "SONARQUBE_TOOLSETS": "issues,quality-gates",
        "SONARQUBE_READ_ONLY": "true"
      }
    }
  }
}

การกำหนดค่าไคลเอ็นต์ (SonarQube Server):

{
  "mcpServers": {
    "sonarqube-https": {
      "url": "https://your-server:8443/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>",
        "SONARQUBE_TOOLSETS": "issues,quality-gates",
        "SONARQUBE_READ_ONLY": "true"
      }
    }
  }
}

หมายเหตุ: SONARQUBE_TOOLSETS และ SONARQUBE_READ_ONLY เป็นส่วนหัวคำขอที่ไม่บังคับ ซึ่งใช้จำกัดชุดเครื่องมือระดับเซิร์ฟเวอร์สำหรับคำขอนั้นโดยเฉพาะ ทำได้เพียงลดขอบเขตเท่านั้น ไม่สามารถเปิดใช้ชุดเครื่องมือหรือยกเลิกข้อจำกัดที่กำหนดไว้ตอนเริ่มเซิร์ฟเวอร์ได้

หมายเหตุ: สำหรับการพัฒนาในเครื่อง ให้ใช้การขนส่ง Stdio แทน (ซึ่งเป็นค่าเริ่มต้น) Streamable HTTP ผ่าน HTTPS มีไว้สำหรับการติดตั้งใช้งานจริงแบบหลายผู้ใช้ที่มีใบรับรอง SSL ที่เหมาะสม

OAuth สำหรับ SonarQube Cloud ที่โฮสต์

การรองรับ OAuth มุ่งเป้าไปที่บริการ MCP ของ SonarQube Cloud ที่โฮสต์โดย Sonar ใช้ไคลเอ็นต์ MCP ที่รองรับ OAuth แล้วลงชื่อเข้าใช้เมื่อระบบแจ้ง ไม่จำเป็นต้องตั้งค่าเซิร์ฟเวอร์ OAuth ในการกำหนดค่าไคลเอ็นต์ ไคลเอ็นต์ที่ใช้โทเค็น SonarQube เดิมยังคงรองรับ

ขอบเขต mcp:tools:read และ mcp:tools:write ควบคุมการเข้าถึงเครื่องมืออ่านและเขียนแยกจากกัน โดยขึ้นอยู่กับสิทธิ์ Cloud ของคุณ ใช้ list_organizations และอาร์กิวเมนต์ organization ของเครื่องมือเพื่อเลือกองค์กร

การติดตั้งใช้งานแบบโฮสต์เองยังคงใช้โทเค็น SonarQube โดยยังไม่รองรับ OAuth สำหรับ SonarQube Server

ปลายทางบริการ

เมื่อทำงานในโหมด Streamable HTTP (http หรือ https) เซิร์ฟเวอร์จะเปิดเผยปลายทางบริการบางรายการที่ไม่ต้องยืนยันตัวตนเพิ่มเติมจากปลายทาง MCP ที่ /mcp ปลายทางเหล่านี้มีไว้สำหรับการสื่อสารระหว่างบริการ (การตรวจสอบ การจัดการระบบ การตรวจสอบความเข้ากันได้ของไคลเอ็นต์) และไม่ต้องใช้ส่วนหัว Authorization

ปลายทางเหล่านี้ไม่พร้อมใช้งานเมื่อทำงานด้วยการขนส่ง Stdio

ใบรับรองแบบกำหนดเอง

หาก SonarQube Server ของคุณใช้ใบรับรองที่ลงนามด้วยตนเอง หรือใบรับรองจากผู้ออกใบรับรอง (CA) ส่วนตัว คุณสามารถเพิ่มใบรับรองแบบกำหนดเองลงในคอนเทนเนอร์ ซึ่งจะติดตั้งให้โดยอัตโนมัติ

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

{
  "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>"
    }
  }
}

พร็อกซี

SonarQube MCP Server รองรับพร็อกซี HTTP และ SOCKS5 ผ่านคุณสมบัติพร็อกซีระบบมาตรฐานของ Java

ใบรับรองไคลเอ็นต์ (Mutual TLS)

หาก SonarQube Server ของคุณกำหนดให้ไคลเอ็นต์ต้องแสดงใบรับรองระหว่างการจับมือ TLS (mutual TLS) คุณสามารถระบุ keystore PKCS12 โดยเมานต์ไว้ในคอนเทนเนอร์และส่งตำแหน่งผ่าน 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

{
  "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>"
    }
  }
}

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>

{
  "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>"
    }
  }
}

เครื่องมือ

การวิเคราะห์

• analyze_code_snippet - วิเคราะห์เนื้อหาไฟล์ด้วยตัววิเคราะห์ของ SonarQube เพื่อระบุปัญหาด้านคุณภาพโค้ดและความปลอดภัย โดยจะวิเคราะห์เนื้อหาไฟล์ทั้งหมดเสมอเพื่อให้ได้ผลลัพธ์ที่แม่นยำ สามารถกรองผลลัพธ์ให้เหลือเฉพาะส่วนย่อยของโค้ดที่ระบุได้

  เลิกใช้แล้ว: analyze_code_snippet จะถูกนำออกในรุ่นอนาคต เชื่อมต่อ SonarQube for IDE เพื่อใช้ analyze_file_list หรือเปิดใช้การวิเคราะห์ Vortex สำหรับองค์กรของคุณเพื่อใช้ run_advanced_code_analysis (ดูด้านล่าง)

  การใช้งาน:

  • เมานต์ workspace แล้ว (แนะนำ): ส่ง filePath (สัมพันธ์กับโปรเจกต์) — เซิร์ฟเวอร์จะอ่านไฟล์โดยตรง ทำให้เนื้อหาไฟล์ไม่อยู่ในหน้าต่างบริบทของเอเจนต์
  • ไม่ได้เมานต์ workspace: ส่ง fileContent ทั้งหมดเพื่อวิเคราะห์ไฟล์อย่างครบถ้วน (รายงานปัญหาทั้งหมด)
  • เพิ่ม codeSnippet ซึ่งเป็นตัวเลือกเพื่อกรองผลลัพธ์ โดยจะรายงานเฉพาะปัญหาภายใน snippet (ตรวจหาตำแหน่ง snippet โดยอัตโนมัติ)

  พารามิเตอร์:

  • organization - คีย์องค์กร SonarQube Cloud - สตริงที่ไม่บังคับ ใช้ได้เฉพาะ Cloud
  • projectKey - คีย์โปรเจกต์ SonarQube - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY แล้ว)
  • filePath - พาธของไฟล์ที่สัมพันธ์กับโปรเจกต์เพื่อวิเคราะห์ (เช่น src/main/java/MyClass.java) ใช้เมื่อเมานต์ workspace ที่ /app/mcp-workspace - สตริง
  • fileContent - เนื้อหาไฟล์ทั้งหมดในรูปแบบสตริง จำเป็นเมื่อไม่ได้เมานต์ workspace - สตริง
  • codeSnippet - โค้ด snippet สำหรับกรองปัญหา (ต้องตรงกับเนื้อหาใน fileContent) - สตริง
  • language - ภาษาของโค้ด (เช่น 'java', 'python', 'js', 'ts', 'tsx', 'jsx') - สตริง
  • scope - ขอบเขตของไฟล์: MAIN หรือ TEST (ค่าเริ่มต้น: MAIN) - สตริง

  ภาษาที่รองรับ: Java, Kotlin, Python, Ruby, Go, JavaScript (js, jsx), TypeScript (ts, tsx), JSP, PHP, XML, HTML, CSS, CloudFormation, Kubernetes, Terraform, Azure Resource Manager, Ansible, Docker, การตรวจจับ Secrets

เมื่อเปิดใช้การผสานรวมกับ SonarQube for IDE: (เครื่องมือทั้งสองนี้ติดแท็กอยู่ในชุดเครื่องมือ analysis และ ide)

• analyze_file_list - วิเคราะห์ไฟล์ในไดเรกทอรีทำงานปัจจุบันโดยใช้ SonarQube for IDE เครื่องมือนี้เชื่อมต่อกับอินสแตนซ์ SonarQube for IDE ที่กำลังทำงานอยู่เพื่อวิเคราะห์คุณภาพโค้ดในรายการไฟล์

  • file_absolute_paths - รายการพาธไฟล์แบบสัมบูรณ์ที่จะวิเคราะห์ - String[] ที่จำเป็น

• toggle_automatic_analysis - เปิดหรือปิดการวิเคราะห์อัตโนมัติของ SonarQube for IDE เมื่อเปิดใช้ SonarQube for IDE จะวิเคราะห์ไฟล์โดยอัตโนมัติเมื่อมีการแก้ไขในไดเรกทอรีทำงาน เมื่อปิดใช้ การวิเคราะห์อัตโนมัติจะหยุดทำงาน

  • enabled - เปิดหรือปิดการวิเคราะห์อัตโนมัติ - Boolean ที่จำเป็น

บน SonarQube Server, stdio จะแสดงเครื่องมือบริบท Vortex และ run_advanced_code_analysis เมื่อมีสิทธิ์ใช้ทั้งฮับ CAG และ A3S

เมื่อการวิเคราะห์ Vortex พร้อมใช้งาน:

ต้องเมานต์ workspace ที่ /app/mcp-workspace

• run_advanced_code_analysis - เรียกใช้การวิเคราะห์ Vortex กับไฟล์เดียว SonarQube Server ใช้ตัวแทน UUID nil
  • organization - คีย์องค์กร SonarQube Cloud - สตริงที่ไม่บังคับ ใช้ได้เฉพาะ Cloud
  • projectKey - คีย์ของโปรเจกต์ - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY แล้ว)
  • branch - ชื่อ branch ที่ใช้ดึงบริบทการวิเคราะห์ล่าสุด - สตริงที่จำเป็น
  • filePath - พาธของไฟล์ที่สัมพันธ์กับโปรเจกต์เพื่อวิเคราะห์ (เช่น src/main/java/MyClass.java) - สตริงที่จำเป็น
  • fileScope - ระบุขอบเขตที่ไฟล์อยู่: 'MAIN' หรือ 'TEST' (ค่าเริ่มต้น: MAIN) - สตริง

ความครอบคลุมของการทดสอบ

• search_files_by_coverage - ค้นหาไฟล์ในโปรเจกต์โดยเรียงตามความครอบคลุมของการทดสอบจากน้อยไปมาก (ไฟล์ที่มีความครอบคลุมต่ำสุดอยู่ก่อน) เครื่องมือนี้ช่วยระบุไฟล์ที่ต้องปรับปรุงความครอบคลุมของการทดสอบ

  • projectKey - คีย์โปรเจกต์ที่จะค้นหา - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY แล้ว)
  • branch - ชื่อ branch ที่ไม่บังคับสำหรับการวิเคราะห์ตาม branch ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - สตริง
  • pullRequest - คีย์/ID ของ pull request ที่ไม่บังคับ ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - สตริง
  • maxCoverage - เกณฑ์สูงสุดของความครอบคลุม (0-100) แสดงเฉพาะไฟล์ที่มีความครอบคลุม <= ค่านี้ - ตัวเลข
  • pageIndex - ดัชนีหน้า (เริ่มที่ 1 ค่าเริ่มต้น: 1) - ตัวเลข
  • pageSize - ขนาดหน้า (ค่าเริ่มต้น: 100 สูงสุด: 500) - ตัวเลข

• get_file_coverage_details - รับข้อมูลความครอบคลุมของการทดสอบทีละบรรทัดสำหรับไฟล์ที่ระบุ รวมถึงบรรทัดที่ไม่มีการทดสอบครอบคลุมและบรรทัดที่มี branch ซึ่งได้รับการทดสอบเพียงบางส่วน เครื่องมือนี้ช่วยระบุตำแหน่งที่ต้องเพิ่มความครอบคลุมของการทดสอบได้อย่างแม่นยำ ใช้หลังจากระบุไฟล์ที่มีความครอบคลุมต่ำด้วย search_files_by_coverage

  • key - คีย์ไฟล์ (เช่น my_project:src/foo/Bar.java) - สตริงที่จำเป็น
  • branch - ชื่อ branch ที่ไม่บังคับสำหรับการวิเคราะห์ตาม branch ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - สตริง
  • pullRequest - คีย์/ID ของ pull request ที่ไม่บังคับ ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - สตริง
  • from - บรรทัดแรกที่จะวิเคราะห์ (เริ่มที่ 1 ค่าเริ่มต้น: 1) - ตัวเลข
  • to - บรรทัดสุดท้ายที่จะวิเคราะห์ (รวมบรรทัดนี้ด้วย) หากไม่ระบุ จะแสดงทุกบรรทัด - ตัวเลข

ความเสี่ยงจาก Dependency

หมายเหตุ: ความเสี่ยงจาก Dependency ต้องใช้ SonarQube Advanced Security บน SonarQube Server ต้องใช้รุ่น 2025.4 Enterprise ขึ้นไป

• search_dependency_risks - ค้นหาปัญหาการวิเคราะห์องค์ประกอบซอฟต์แวร์ (ความเสี่ยงจาก dependency) ของโปรเจกต์ SonarQube พร้อมกับรุ่นที่ปรากฏในโปรเจกต์ แอปพลิเคชัน หรือพอร์ตโฟลิโอที่วิเคราะห์
  • organization - คีย์องค์กร SonarQube Cloud - สตริงที่ไม่บังคับ ใช้ได้เฉพาะ Cloud
  • projectKey - คีย์โปรเจกต์ - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY แล้ว)
  • branch - ชื่อ branch ที่ไม่บังคับสำหรับการวิเคราะห์ตาม branch ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - สตริง
  • pullRequest - คีย์/ID ของ pull request ที่ไม่บังคับ ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - สตริง
  • pageIndex - ดัชนีหน้าที่ไม่บังคับ (เริ่มที่ 1 ค่าเริ่มต้น: 1) - จำนวนเต็ม
  • pageSize - ขนาดหน้าที่ไม่บังคับ ต้องมากกว่า 0 และไม่เกิน 500 (ค่าเริ่มต้น: 100) - จำนวนเต็ม

องค์กร

หมายเหตุ: องค์กรพร้อมใช้งานเฉพาะเมื่อเชื่อมต่อกับ SonarQube Cloud เท่านั้น

• list_enterprises - แสดงรายการองค์กรที่คุณเข้าถึงได้ใน SonarQube Cloud ใช้เครื่องมือนี้เพื่อค้นหา ID องค์กรที่ใช้กับเครื่องมืออื่นได้
  • enterpriseKey - คีย์องค์กรที่ไม่บังคับสำหรับกรองผลลัพธ์ - สตริง

Issues

• change_sonar_issue_status - เปลี่ยนสถานะของ issue ใน SonarQube เป็น "accept", "falsepositive" หรือ "reopen"

  • key - คีย์ issue - สตริงที่จำเป็น
  • status - สถานะใหม่ของ issue - Enum ที่จำเป็น {"accept", "falsepositive", "reopen"}
  • comment - ความคิดเห็นที่ไม่บังคับเพื่ออธิบายการเปลี่ยนสถานะ - สตริง

• search_sonar_issues_in_projects - ค้นหา issue ของ SonarQube ในโปรเจกต์ขององค์กรของฉัน

  • organization - คีย์องค์กร SonarQube Cloud - สตริงที่ไม่บังคับ ใช้ได้เฉพาะ Cloud
  • projectKeys - รายการคีย์โปรเจกต์ SonarQube ที่ไม่บังคับ - String[]
  • branch - ชื่อ branch ที่ไม่บังคับสำหรับการวิเคราะห์ตาม branch ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - สตริง
  • pullRequest - คีย์/ID ของ pull request ที่ไม่บังคับ ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - สตริง
  • severities - รายการระดับความรุนแรงที่ไม่บังคับสำหรับกรอง ค่าที่เป็นไปได้: INFO, LOW, MEDIUM, HIGH, BLOCKER - String[]
  • impactSoftwareQualities - รายการคุณภาพซอฟต์แวร์ที่ไม่บังคับสำหรับกรอง ค่าที่เป็นไปได้: MAINTAINABILITY, RELIABILITY, SECURITY - String[]
  • issueStatuses - รายการสถานะ issue ที่ไม่บังคับสำหรับกรอง ค่าที่เป็นไปได้: OPEN, CONFIRMED, FALSE_POSITIVE, ACCEPTED, FIXED, IN_SANDBOX - String[]
  • tags - รายการแท็ก issue ที่ไม่บังคับสำหรับกรอง แท็กจะเป็นตัวพิมพ์เล็ก - String[]
  • inNewCodePeriod - แสดงเฉพาะ issue ในช่วงโค้ดใหม่ ต้องมีรายการเพียงหนึ่งรายการใน projectKeys และ files - Boolean
  • issueKey - คีย์ issue ที่ไม่บังคับเพื่อดึง issue ที่ระบุ - สตริง
  • pageIndex - ดัชนีหน้าที่ไม่บังคับ (เริ่มที่ 1 ค่าเริ่มต้น: 1) - จำนวนเต็ม
  • pageSize - ขนาดหน้าที่ไม่บังคับ ต้องมากกว่า 0 และไม่เกิน 500 (ค่าเริ่มต้น: 100) - จำนวนเต็ม

Security Hotspots

• search_security_hotspots - ค้นหา Security Hotspots ในโปรเจกต์ SonarQube

  • projectKey - คีย์โปรเจกต์หรือแอปพลิเคชัน - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY แล้ว)
  • hotspotKeys - รายการคีย์ Security Hotspot ที่ระบุโดยคั่นด้วยจุลภาคเพื่อดึงข้อมูล - String[]
  • branch - ชื่อ branch ที่ไม่บังคับสำหรับการวิเคราะห์ตาม branch ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - สตริง
  • pullRequest - คีย์/ID ของ pull request ที่ไม่บังคับ ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - สตริง
  • files - รายการพาธไฟล์ที่ไม่บังคับสำหรับกรอง - String[]
  • status - ตัวกรองสถานะที่ไม่บังคับ: TO_REVIEW, REVIEWED - สตริง
  • resolution - ตัวกรองการแก้ไขที่ไม่บังคับ: FIXED, SAFE, ACKNOWLEDGED - สตริง
  • sinceLeakPeriod - กรอง hotspot ที่สร้างขึ้นตั้งแต่ช่วง leak (โค้ดใหม่) - Boolean
  • onlyMine - แสดงเฉพาะ hotspot ที่มอบหมายให้ฉัน - Boolean
  • pageIndex - ดัชนีหน้าที่ไม่บังคับ (เริ่มที่ 1 ค่าเริ่มต้น: 1) - จำนวนเต็ม
  • pageSize - ขนาดหน้าที่ไม่บังคับ ต้องมากกว่า 0 และไม่เกิน 500 (ค่าเริ่มต้น: 100) - จำนวนเต็ม

• show_security_hotspot - รับข้อมูลโดยละเอียดเกี่ยวกับ Security Hotspot ที่ระบุ รวมถึงรายละเอียดกฎ บริบทของโค้ด โฟลว์ และความคิดเห็น

  • hotspotKey - คีย์ Security Hotspot - สตริงที่จำเป็น

• change_security_hotspot_status - ตรวจทาน Security Hotspot โดยเปลี่ยนสถานะ เมื่อตั้งสถานะเป็น REVIEWED ต้องระบุการแก้ไข (FIXED, SAFE หรือ ACKNOWLEDGED)

  • hotspotKey - คีย์ Security Hotspot - สตริงที่จำเป็น
  • status - สถานะใหม่ - Enum ที่จำเป็น {"TO_REVIEW", "REVIEWED"}
  • resolution - การแก้ไขเมื่อสถานะเป็น REVIEWED - Enum {"FIXED", "SAFE", "ACKNOWLEDGED"}
  • comment - ความคิดเห็นการตรวจทานที่ไม่บังคับ - สตริง

ภาษา

• list_languages - แสดงรายการภาษาการเขียนโปรแกรมทั้งหมดที่รองรับในอินสแตนซ์ SonarQube นี้
  • q - รูปแบบที่ไม่บังคับสำหรับจับคู่กับคีย์/ชื่อภาษา - สตริง

Measures

• get_component_measures - รับค่าการวัดของ SonarQube สำหรับคอมโพเนนต์ (โปรเจกต์ ไดเรกทอรี ไฟล์)
  • projectKey - คีย์โปรเจกต์ - _สตริงที่จำเป็นเมื่อไม่ได้กำหนดค่า SONARQUBE_PROJECT_KEY
  • branch - ชื่อ branch ที่ไม่บังคับสำหรับการวิเคราะห์ตาม branch ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - สตริง
  • metricKeys - คีย์ metric ที่ไม่บังคับสำหรับดึงข้อมูล (เช่น ncloc, complexity, violations, coverage) - String[]
  • pullRequest - คีย์/ID ของ pull request ที่ไม่บังคับ ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - สตริง

Metrics

• search_metrics - ค้นหา metric ของ SonarQube
  • pageIndex - ดัชนีหน้าที่ไม่บังคับ (เริ่มที่ 1 ค่าเริ่มต้น: 1) - จำนวนเต็ม
  • pageSize - ขนาดหน้าที่ไม่บังคับ ต้องมากกว่า 0 และไม่เกิน 500 (ค่าเริ่มต้น: 100) - จำนวนเต็ม

พอร์ตโฟลิโอ

• list_portfolios - แสดงรายการพอร์ตโฟลิโอระดับองค์กรที่มีใน SonarQube พร้อมตัวเลือกการกรองและการแบ่งหน้า

  สำหรับ SonarQube Server:

  • q - คำค้นหาที่ไม่บังคับเพื่อกรองพอร์ตโฟลิโอตามชื่อหรือคีย์ - สตริง
  • favorite - หากเป็น true จะแสดงเฉพาะพอร์ตโฟลิโอรายการโปรด - Boolean
  • pageIndex - หมายเลขหน้าที่ไม่บังคับ (เริ่มที่ 1 ค่าเริ่มต้น: 1) - จำนวนเต็ม
  • pageSize - ขนาดหน้าที่ไม่บังคับ สูงสุด 500 (ค่าเริ่มต้น: 100) - จำนวนเต็ม

  สำหรับ SonarQube Cloud:

  • enterpriseId - UUID ของ Enterprise สามารถละเว้นได้เฉพาะเมื่อระบุพารามิเตอร์ 'favorite' เป็นค่า true - String
  • q - คำค้นหาเพิ่มเติมที่ไม่บังคับเพื่อกรองพอร์ตโฟลิโอตามชื่อ - String
  • favorite - ต้องเป็น true หากละเว้นพารามิเตอร์ 'enterpriseId' หากเป็น true จะแสดงเฉพาะพอร์ตโฟลิโอที่ผู้ใช้ที่เข้าสู่ระบบทำเครื่องหมายเป็นรายการโปรด ไม่สามารถเป็น true เมื่อ 'draft' เป็น true - Boolean
  • draft - หากเป็น true จะแสดงเฉพาะฉบับร่างที่ผู้ใช้ที่เข้าสู่ระบบสร้างขึ้น ไม่สามารถเป็น true เมื่อ 'favorite' เป็น true - Boolean
  • pageIndex - ดัชนีของหน้าที่จะดึงข้อมูล (ค่าเริ่มต้น: 1) - Integer
  • pageSize - ขนาดของหน้าที่จะดึงข้อมูล (ค่าเริ่มต้น: 50) - Integer

โปรเจกต์

• list_organizations - แสดงรายการองค์กร SonarQube Cloud ที่ผู้ใช้เป็นสมาชิก รวมถึงคีย์ ชื่อ ID และ UUID ใช้คีย์ที่ส่งคืนเป็น organization ในเครื่องมือถัดไป

• search_my_sonarqube_projects - ค้นหาโปรเจกต์ SonarQube ผลลัพธ์แบ่งเป็นหน้า

  • organization - คีย์องค์กร SonarQube Cloud - Optional String, Cloud only
  • pageIndex - ดัชนีหน้าแบบเริ่มนับจาก 1 (ค่าเริ่มต้น: 1) - Integer
  • pageSize - ขนาดหน้าที่ไม่บังคับ ต้องมากกว่า 0 และน้อยกว่าหรือเท่ากับ 500 (ค่าเริ่มต้น: 500) - Integer
  • q - คำค้นหาเพิ่มเติมที่ไม่บังคับเพื่อกรองโปรเจกต์ตามชื่อ (ตรงกันบางส่วน) หรือคีย์ (ตรงกันทุกประการ) - String

• list_branches - แสดงรายการสาขาที่วิเคราะห์แล้วของโปรเจกต์

  • SonarQube Cloud: ส่งคืนสาขาที่มีอายุยาว (LONG) และสาขาที่มีอายุสั้น (SHORT) พร้อมฟิลด์ type และ mergeBranch ตัวกรอง branchTypes เป็นตัวเลือก: ALL (ค่าเริ่มต้น), LONG หรือ SHORT
  • SonarQube Server: ส่งคืนสาขาที่วิเคราะห์แล้วทั้งหมด (ชื่อ เกตคุณภาพ วันที่วิเคราะห์) ไม่มีตัวกรอง type, mergeBranch หรือ branchTypes
  • ใช้ชื่อสาขาที่ส่งคืนเป็นพารามิเตอร์ branch ในเครื่องมืออื่น สำหรับการวิเคราะห์ pull request ให้ใช้ list_pull_requests แทน
  • projectKey - คีย์โปรเจกต์ (เช่น my_project) - Required String (ละเว้นเมื่อกำหนด SONARQUBE_PROJECT_KEY)
  • branchTypes - (SonarQube Cloud only) ตัวกรองเพิ่มเติม: ALL (ค่าเริ่มต้น), LONG หรือ SHORT - Enum {"ALL", "LONG", "SHORT"}

• list_pull_requests - แสดงรายการ pull request ทั้งหมดของโปรเจกต์ ใช้เครื่องมือนี้เพื่อค้นหา pull request สำหรับการวิเคราะห์ที่ตกแต่ง PR (ความครอบคลุม ปัญหา เกตคุณภาพ) ส่งคืนคีย์/ID ของ pull request ซึ่งใช้กับเครื่องมืออื่นได้ สำหรับการวิเคราะห์ตามสาขาที่ไม่มี pull request ให้ใช้ list_branches แทน

  • projectKey - คีย์โปรเจกต์ (เช่น my_project) - Required String (ละเว้นเมื่อกำหนด SONARQUBE_PROJECT_KEY)

เกตคุณภาพ

• get_project_quality_gate_status - รับสถานะเกตคุณภาพของโปรเจกต์ SonarQube

  • analysisId - ID การวิเคราะห์ (ไม่บังคับ) - String
  • branch - ชื่อสาขาสำหรับการวิเคราะห์ตามสาขา (ไม่บังคับ) ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - String
  • projectId - ID โปรเจกต์ (ไม่บังคับ) - String
  • projectKey - คีย์โปรเจกต์ (ไม่บังคับ) - String
  • pullRequest - คีย์/ID ของ pull request (ไม่บังคับ) ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - String

• list_quality_gates - แสดงรายการเกตคุณภาพทั้งหมดใน SonarQube ของฉัน

  • organization - คีย์องค์กร SonarQube Cloud - Optional String, Cloud only

กฎ

• show_rule - แสดงข้อมูลโดยละเอียดเกี่ยวกับกฎ SonarQube
  • organization - คีย์องค์กร SonarQube Cloud - Optional String, Cloud only
  • key - คีย์กฎ - Required String

โค้ดซ้ำ

• search_duplicated_files - ค้นหาไฟล์ที่มีโค้ดซ้ำในโปรเจกต์ SonarQube โดยค่าเริ่มต้น จะดึงไฟล์ที่มีโค้ดซ้ำทั้งหมดจากทุกหน้าโดยอัตโนมัติ (สูงสุด 10,000 ไฟล์) ส่งคืนเฉพาะไฟล์ที่มีโค้ดซ้ำ

  • projectKey - คีย์โปรเจกต์ - Required String (ละเว้นเมื่อกำหนด SONARQUBE_PROJECT_KEY)
  • branch - ชื่อสาขาสำหรับการวิเคราะห์ตามสาขา (ไม่บังคับ) ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - String
  • pullRequest - คีย์/ID ของ pull request (ไม่บังคับ) ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - String
  • pageSize - จำนวนผลลัพธ์ต่อหน้าสำหรับการแบ่งหน้าแบบกำหนดเอง (ไม่บังคับ) (สูงสุด: 500) หากไม่ระบุ จะดึงไฟล์ที่มีโค้ดซ้ำทั้งหมดโดยอัตโนมัติ - Integer
  • pageIndex - หมายเลขหน้าเพื่อแบ่งหน้าแบบกำหนดเอง (ไม่บังคับ) (เริ่มที่ 1) หากไม่ระบุ จะดึงไฟล์ที่มีโค้ดซ้ำทั้งหมดโดยอัตโนมัติ - Integer

• get_duplications - รับข้อมูลโค้ดซ้ำของไฟล์ ต้องมีสิทธิ์ Browse ในโปรเจกต์ของไฟล์

  • key - คีย์ไฟล์ - Required String
  • branch - ชื่อสาขาสำหรับการวิเคราะห์ตามสาขา (ไม่บังคับ) ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - String
  • pullRequest - คีย์/ID ของ pull request (ไม่บังคับ) ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - String

ซอร์ส

• get_raw_source - รับซอร์สโค้ดจาก SonarQube ในรูปแบบข้อความดิบ ต้องมีสิทธิ์ 'See Source Code' ในไฟล์

  • key - คีย์ไฟล์ - Required String
  • branch - ชื่อสาขาสำหรับการวิเคราะห์ตามสาขา (ไม่บังคับ) ใช้ list_branches เพื่อค้นหาชื่อที่ถูกต้อง - String
  • pullRequest - คีย์/ID ของ pull request (ไม่บังคับ) ใช้ list_pull_requests เพื่อค้นหาคีย์ที่ถูกต้อง - String

• get_scm_info - รับข้อมูล SCM ของไฟล์ซอร์สใน SonarQube ต้องมีสิทธิ์ See Source Code ในโปรเจกต์ของไฟล์

  • key - คีย์ไฟล์ - Required String
  • commits_by_line - จัดกลุ่มบรรทัดตามคอมมิต SCM หากค่าเป็น false มิฉะนั้นจะแสดงคอมมิตของแต่ละบรรทัด - String
  • from - บรรทัดแรกที่ส่งคืน เริ่มที่ 1 - Number
  • to - บรรทัดสุดท้ายที่ส่งคืน (รวมบรรทัดนี้ด้วย) - Number

ระบบ

หมายเหตุ: เครื่องมือระบบใช้ได้เฉพาะเมื่อเชื่อมต่อกับ SonarQube Server เท่านั้น

• get_system_health - รับสถานะความสมบูรณ์ของอินสแตนซ์ SonarQube Server ส่งคืน GREEN (ทำงานได้เต็มรูปแบบ), YELLOW (ใช้งานได้แต่ต้องได้รับการดูแล) หรือ RED (ไม่ทำงาน)

• get_system_info - รับข้อมูลโดยละเอียดเกี่ยวกับการกำหนดค่าระบบ SonarQube Server รวมถึงสถานะ JVM ฐานข้อมูล ดัชนีการค้นหา และการตั้งค่า ต้องมีสิทธิ์ 'Administer'

• get_system_logs - รับบันทึกระบบ SonarQube Server ในรูปแบบข้อความธรรมดา ต้องมีสิทธิ์ผู้ดูแลระบบ

  • name - ชื่อบันทึกที่ต้องการ (ไม่บังคับ) ค่าที่เป็นไปได้: access, app, ce, deprecation, es, web ค่าเริ่มต้น: app - String

• ping_system - ส่ง ping ไปยังระบบ SonarQube Server เพื่อตรวจสอบว่ายังทำงานอยู่หรือไม่ ส่งคืน 'pong' เป็นข้อความธรรมดา

• get_system_status - รับข้อมูลสถานะของ SonarQube Server ส่งคืนสถานะ (STARTING, UP, DOWN, RESTARTING, DB_MIGRATION_NEEDED, DB_MIGRATION_RUNNING) เวอร์ชัน และ ID

Webhooks

• create_webhook - สร้าง webhook ใหม่สำหรับองค์กรหรือโปรเจกต์ SonarQube ต้องมีสิทธิ์ 'Administer' ในโปรเจกต์ที่ระบุ หรือสิทธิ์ 'Administer' ระดับส่วนกลาง

  • organization - คีย์องค์กร SonarQube Cloud - Optional String, Cloud only
  • name - ชื่อ webhook - Required String
  • url - URL ของ webhook - Required String
  • projectKey - คีย์โปรเจกต์สำหรับ webhook เฉพาะโปรเจกต์ (ไม่บังคับ) - String
  • secret - secret ของ webhook สำหรับรักษาความปลอดภัยของ payload webhook (ไม่บังคับ) - String

• list_webhooks - แสดงรายการ webhook ทั้งหมดขององค์กรหรือโปรเจกต์ SonarQube ต้องมีสิทธิ์ 'Administer' ในโปรเจกต์ที่ระบุ หรือสิทธิ์ 'Administer' ระดับส่วนกลาง

  • organization - คีย์องค์กร SonarQube Cloud - Optional String, Cloud only
  • projectKey - คีย์โปรเจกต์สำหรับแสดงรายการ webhook เฉพาะโปรเจกต์ (ไม่บังคับ) - String

การเพิ่มบริบท

# 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"
      }
    }
  }
}

ความพร้อมสำหรับ Agentic

หมายเหตุ: เครื่องมือ Agentic Readiness ใช้ได้เฉพาะบน SonarQube Cloud และต้องเปิดใช้ฟีเจอร์นี้สำหรับองค์กรของคุณ

ระบบจะตรวจสอบแฟล็กฟีเจอร์ตอนเริ่มต้นในโหมด stdio สำหรับ HTTP/HTTPS ให้เพิ่ม agentic-readiness ลงใน SONARQUBE_TOOLSETS ของเซิร์ฟเวอร์เพื่อเปิดใช้เครื่องมือ

• start_agentic_readiness_assessment - เริ่มการประเมินความพร้อมสำหรับ agentic ของโปรเจกต์ โดยส่งคืนทันทีพร้อมสถานะ PENDING และ assessmentId ใช้ get_agentic_readiness_assessment เพื่อตรวจสอบผลลัพธ์

  • projectKey - คีย์โปรเจกต์ - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY)
  • branch - สาขาที่จะประเมิน เว้นว่างไว้เพื่อใช้สาขาเริ่มต้นของโปรเจกต์ - String

• get_agentic_readiness_assessment - ดึงผลการประเมิน เรียกซ้ำด้วย assessmentId เดิมจนกว่าสถานะจะเป็น COMPLETED, FAILED หรือ INTERRUPTED เมื่อเสร็จสิ้น จะส่งคืนระดับโดยรวมและรายละเอียดแยกตามเสาหลัก พร้อมการดำเนินการที่แนะนำและหลักฐาน

  • assessmentId - ID การประเมินที่ส่งคืนโดย start_agentic_readiness_assessment - สตริงที่จำเป็น

• list_agentic_readiness_assessments - แสดงรายการการประเมินทั้งหมดของโปรเจกต์ โดยเรียงจากใหม่ไปเก่า ใช้ get_agentic_readiness_assessment เพื่อดูผลลัพธ์ระดับเสาหลักทั้งหมด

  • projectKey - คีย์โปรเจกต์ที่ต้องการแสดงรายการการประเมิน - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY)
  • branch - กรองการประเมินตามชื่อสาขา เว้นว่างไว้เพื่อแสดงรายการการประเมินของทุกสาขา - String
  • pageIndex - ดัชนีหน้าเริ่มจาก 1 (ค่าเริ่มต้น: 1) - Number
  • pageSize - จำนวนรายการต่อหน้า สูงสุด 100 (ค่าเริ่มต้น: 50) - Number

สถาปัตยกรรม

หมายเหตุ: เปิดใช้เครื่องมือเหล่านี้ด้วย SONARQUBE_TOOLSETS=architecture ในโหมด stdio หรือ HTTP/HTTPS SonarQube Cloud ต้องใช้แพ็กเกจ Team หรือ Enterprise ส่วน SonarQube Server ต้องเป็นเวอร์ชัน 2026.6 ขึ้นไปและรุ่น Developer ขึ้นไป เครื่องมือเหล่านี้ไม่พร้อมใช้งานในเวอร์ชันเก่าหรือ Community Build ดู เวิร์กโฟลว์สถาปัตยกรรมและการกู้คืน

• architecture_get - อ่านการพึ่งพาปัจจุบัน สถาปัตยกรรมที่ต้องการ คำสั่งของโปรเจกต์ หรือ Findings (ความเบี่ยงเบน ข้อบกพร่อง และกลิ่นโค้ด)

  • target - current, intended, directives หรือ findings; ความพร้อมใช้งานขึ้นอยู่กับ MCP และบิลด์ของ Server - Enum ที่จำเป็น
  • projectKey - คีย์โปรเจกต์ - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY)
  • organization - คีย์องค์กร SonarQube Cloud เมื่อยังไม่ได้กำหนดค่า - สตริงที่ไม่บังคับ ใช้ได้เฉพาะ Cloud
  • component - คีย์โหนดปัจจุบันที่ตรงกันทุกประการหรือพาธกลุ่มที่ต้องการ; หากไม่ระบุจะใช้ระดับบนสุด - String
  • depth - เฉพาะ current/intended: จำนวนระดับที่อยู่ใต้จุดเริ่มต้น; ค่าเริ่มต้นคือ 1 สำหรับ current และทั้งหมดสำหรับ intended - Number
  • language - เฉพาะ current/intended/findings: java, cs, js, ts หรือ py - Enum
  • directiveId - คำสั่งฉบับเต็มตาม UUID รวมถึงคำอธิบาย; ใช้แทนการแบ่งหน้า - String
  • category / type - เฉพาะ Findings: กรองความเบี่ยงเบน ข้อบกพร่อง หรือกลิ่นโค้ดตามประเภทที่ระบุ - Enum
  • pageIndex - Directives/Findings: ดัชนีหน้าเริ่มจาก 1 (ค่าเริ่มต้น: 1) - Number
  • pageSize - Directives: สรุป ค่าเริ่มต้น/สูงสุด 50 Findings: ค่าเริ่มต้น 50 สูงสุด 1000; 0 ใช้สำหรับนับเท่านั้น - Number

• architecture_set - แทนที่สถาปัตยกรรมที่ต้องการทั้งหมด หรือสร้าง อัปเดต และลบคำสั่งของโปรเจกต์ ใช้ได้ในบิลด์ Cloud และ Server ที่รองรับเมื่อเปิดใช้การเขียน

  • target - intended หรือ directives - Enum ที่จำเป็น
  • projectKey - คีย์โปรเจกต์ - สตริงที่จำเป็น (ไม่สนใจเมื่อกำหนด SONARQUBE_PROJECT_KEY)
  • organization - คีย์องค์กร SonarQube Cloud เมื่อยังไม่ได้กำหนดค่า - สตริงที่ไม่บังคับ ใช้ได้เฉพาะ Cloud
  • model - สตริง JSON: export สถาปัตยกรรมที่ต้องการฉบับสมบูรณ์ หรืออาร์เรย์ models (เนื้อหาที่ละไว้จะถูกลบ) หรือการเปลี่ยนแปลงคำสั่งพร้อมอาร์เรย์ create, update และ delete - สตริงที่จำเป็น
  • dryRun - true เพื่อดูตัวอย่างก่อนใช้, false เพื่อใช้การเปลี่ยนแปลง - บูลีนที่จำเป็น
  • revision - เฉพาะ intended: revision จาก architecture_get; ค่าเริ่มต้นคือ revision ของ export ฉบับสมบูรณ์ จำเป็นเมื่อใช้ clear - String

ตัวอย่างพรอมป์ต์

เมื่อตั้งค่า SonarQube MCP Server แล้ว ต่อไปนี้คือตัวอย่างพรอมป์ต์สำหรับสถานการณ์ทั่วไปในโลกจริง:

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?

การสร้าง

แนะนำให้ใช้คอนเทนเนอร์อิมเมจ sonarsource/sonarqube-mcp

หากต้องการเรียกใช้เซิร์ฟเวอร์เป็น JAR แบบสแตนด์อโลนโดยไม่ใช้ Docker ให้ดาวน์โหลดรีลีสที่สร้างไว้ล่วงหน้าจาก คลังไบนารีของ SonarSource เวอร์ชันที่เผยแพร่ทุกเวอร์ชันจะอยู่ที่นั่นในรูปแบบ sonarqube-mcp-server-<version>.jar (ตัวอย่างเช่น sonarqube-mcp-server-1.19.0.2785.jar)

{
  "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": {
    "command": "java",
    "args": [
      "-jar",
      "<path_to_sonarqube_mcp_server_jar>"
    ],
    "env": {
      "STORAGE_PATH": "<path_to_your_mcp_storage>",
      "SONARQUBE_TOKEN": "<token>",
      "SONARQUBE_URL": "<url>"
    }
  }
}

./gradlew clean build -x test

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

การแก้ไขปัญหา

โดยค่าเริ่มต้น บันทึกของแอปพลิเคชันจะเขียนลงในไฟล์ STORAGE_PATH/logs/mcp.log หากต้องการปิดการบันทึกลงไฟล์ทั้งหมด ให้ตั้งค่า SONARQUBE_LOG_TO_FILE_DISABLED=true

ปัญหาที่พบบ่อย

"ไม่รองรับเวอร์ชันเซิร์ฟเวอร์ SonarQube"

เซิร์ฟเวอร์ MCP จะตรวจสอบเวอร์ชันของ SonarQube Server ที่เชื่อมต่อระหว่างเริ่มต้น หากอินสแตนซ์เก่ากว่า 2025.1 (SQS) หรือ 25.1 (SQCB) การเริ่มต้นจะล้มเหลวพร้อมข้อความ:

SonarQube server version is not supported, minimal version is SQS 2025.1 or SQCB 25.1

วิธีแก้ไข: อัปเกรด SonarQube Server เป็นรีลีสที่รองรับ การตรวจสอบนี้ใช้เฉพาะเมื่อเชื่อมต่อกับ SonarQube Server (SONARQUBE_URL โดยไม่มี SONARQUBE_ORG) ไม่ใช้กับ SonarQube Cloud

"ฟีเจอร์ไม่ทำงาน" หรือ "เครื่องมือ/ฟังก์ชันการทำงานหายไป"

คุณอาจกำลังใช้ Docker image ที่ล้าสมัย Docker จะเก็บ image ไว้ในแคชภายในเครื่อง จึงไม่ได้รับการอัปเดตโดยอัตโนมัติ

วิธีแก้ไข: อัปเดตเป็นเวอร์ชันล่าสุด:

docker pull sonarsource/sonarqube-mcp

หลังจากดึง image ล่าสุดแล้ว ให้รีสตาร์ตไคลเอ็นต์ MCP เพื่อใช้เวอร์ชันที่อัปเดต

หากต้องการ คุณสามารถเพิ่มแฟล็ก --pull=always ในคำสั่ง docker run เพื่อให้ตรวจสอบและดึงเวอร์ชันล่าสุดทุกครั้ง:

docker run --init --pull=always -i --rm -e SONARQUBE_TOKEN -e SONARQUBE_ORG sonarsource/sonarqube-mcp

"ฉันต้องการตรึงไว้ที่เวอร์ชันที่ระบุ"

ดูแท็กที่มีได้ที่ sonarsource/sonarqube-mcp แล้วอ้างอิงเวอร์ชันที่ต้องการ:

docker pull sonarsource/sonarqube-mcp:1.19.0.2785

docker run --init -i --rm \
  -e SONARQUBE_TOKEN -e SONARQUBE_ORG \
  sonarsource/sonarqube-mcp:1.19.0.2785

ในการกำหนดค่าไคลเอ็นต์ MCP ให้ใช้ sonarsource/sonarqube-mcp:<version> แทน sonarsource/sonarqube-mcp และนำ --pull=always ออก เพื่อไม่ให้ Docker อัปเกรด image โดยไม่แจ้งให้ทราบ

ข้อมูลและการวัดผลการใช้งาน

เซิร์ฟเวอร์นี้รวบรวมข้อมูลการใช้งานแบบไม่ระบุตัวตนและส่งไปยัง SonarSource เพื่อช่วยปรับปรุงผลิตภัณฑ์ ไม่มีการรวบรวมซอร์สโค้ดหรือที่อยู่ IP และ SonarSource จะไม่แบ่งปันข้อมูลกับบุคคลอื่น คุณสามารถปิดใช้งานการรวบรวมข้อมูลการวัดและส่งข้อมูลทางไกลได้ด้วยคุณสมบัติของระบบหรือตัวแปรสภาพแวดล้อมต่อไปนี้: TELEMETRY_DISABLED=true คลิก ที่นี่ เพื่อดูตัวอย่างข้อมูลที่รวบรวม

ใบอนุญาต

ลิขสิทธิ์ 2025 SonarSource

อนุญาตให้ใช้งานภายใต้ SONAR Source-Available License v1.0 การใช้ SonarQube MCP Server ตามเอกสารนี้ถือเป็นวัตถุประสงค์ที่ไม่ใช่การแข่งขัน จึงได้รับอนุญาตภายใต้ SSAL

การใช้งาน SonarQube ผ่าน MCP ของคุณอยู่ภายใต้ ข้อกำหนดในการให้บริการของ SonarQube Cloud หรือ ข้อกำหนดและเงื่อนไขของ SonarQube Server รวมถึงการใช้ข้อมูลผลลัพธ์เพื่อวัตถุประสงค์ในการพัฒนาซอฟต์แวร์ภายในองค์กรของคุณเท่านั้น