이 문서는 SonarQube for IDE(구 SonarLint)와 SonarQube MCP 연동에 대해 Cursor를 기준으로 설명합니다.
개요
SonarQube MCP Server는 SonarQube for IDE(구 SonarLint)와 연동하여 개발 환경 내에서 더 향상된 코드 분석과 인사이트를 제공합니다.
이를 통해 개발자는 IDE 내에서 SonarQube Server의 분석 기능을 실시간으로 활용하며, 보다 정교한 품질 점검과 피드백을 받을 수 있습니다.
SonarQube for IDE
아래 링크에서 SonarQube for IDE에 대한 설명과 설치 방법을 볼 수 있습니다.
기본 SonarQube MCP 연동과 차이점
각 연동 방법에 따라 Agent가 실행할 Tool 세트가 달라집니다.
기본
SonarQube Server/Cloud와 MCP 통신
프로젝트 전체 수준의 품질 게이트 분석
서버 데이터 기반
SonarQube for IDE
SonarQube for IDE는 Extension과 MCP 통신
IDE에서 현재 작업 중인 파일 분석
두 가지 함께 구성하면, Agent가 목적에 맞게 활용할 수 있도록 할 수 있습니다.
SonarQube for IDE에 SonarQube MCP 설정
기본 SonarQube MCP 연동 방법에서 환경변수에 SONARQUBE_IDE_PORT가 추가하면, SonarQube for IDE와 SonarQube MCP Server 연동으로 전환됩니다.
즉, SONARQUBE_IDE_PORT 여부에 따라 MCP 서버 기본 연동, SonarQube for IDE 연동이 바뀝니다.
SonarQube Setup의 서버 목록에서 연결하고자 하는 서버의 MCP Icon 또는 “Configure SonarQube MCP Server” 버튼 클릭합니다.
mcp.json에 아래 내용이 추가됩니다.
- Port번호는 SonarQube for IDE Extension이 SonarQube Server와 통신하기 위해 사용중인 Port를 의미함 (기본: 64120, 범위 : 64120-64130)
{
"mcpServers": {
"sonarqube": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SONARQUBE_TOKEN",
"-e",
"SONARQUBE_URL",
"-e",
"SONARQUBE_IDE_PORT",
"mcp/sonarqube"
],
"env": {
"SONARQUBE_URL": "<SonarQube 서버 주소>",
"SONARQUBE_TOKEN": "<SonarQube 사용자 토큰>",
"SONARQUBE_IDE_PORT": "<SonarQube for IDE port (기본: 64120)>"
}
}
}
}