sonarqube-mcp-py
Integrates with SonarQube to query projects, issues, quality gates, coverage metrics, security hotspots, and code duplication, enabling AI agents to perform code quality analysis and monitoring.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sonarqube-mcp-py get quality gate status for project my-app"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sonarqube-mcp-py
A Python MCP server for SonarQube — query projects, issues, quality gates, coverage, and security hotspots directly from any MCP-compatible AI agent.
Inspired by the official SonarQube MCP Server (Java/Kotlin), reimplemented in Python for lightweight deployment without JVM dependency.
Install
uvx sonarqube-mcp-py
# or
pip install sonarqube-mcp-pyRelated MCP server: sonar-mcp
Configuration
Set environment variables:
export SONARQUBE_URL=https://your-sonarqube-instance
export SONARQUBE_TOKEN=squ_your_token_here
export SONARQUBE_VERIFY_SSL=false # optional, for self-signed certsTransport
stdio (default): for
mcp.jsonintegration with Claude Desktop, Cursor, Kiro CLI, etc.HTTP: set
MCP_TRANSPORT=streamable-httpand optionallyMCP_PORT=8959
Available Tools
Tool | Description |
| Search for projects |
| Get quality gate status (OK/ERROR) |
| Get metrics (bugs, coverage, code smells, etc.) |
| List all quality gate definitions |
| Search issues by severity and status |
| Find security hotspots to review |
| Get hotspot details |
| Get rule description and examples |
| List all available metrics |
| List analyzed pull requests |
| Get per-file coverage data |
| Find files with lowest coverage |
| Get code duplication details |
MCP Client Configuration
stdio (mcp.json)
{
"sonarqube": {
"command": "sonarqube-mcp-py",
"env": {
"SONARQUBE_URL": "https://your-instance",
"SONARQUBE_TOKEN": "squ_xxx"
}
}
}HTTP (standalone service)
{
"sonarqube": {
"url": "http://localhost:8959/mcp"
}
}Start in HTTP mode:
MCP_TRANSPORT=streamable-http MCP_PORT=8959 sonarqube-mcp-pyLicense
MIT
Available Tools
13 toolsget_component_measuresC
Get metrics for a component (bugs, coverage, etc.)
Inputs: component (required), metric_keys (required), branch.
get_duplicationsC
Get code duplications for a file
Inputs: file_key (required), branch.
get_file_coverage_detailsC
Get coverage details for files in a project
Inputs: component (required), page_size, branch.
get_project_quality_gate_statusC
Get quality gate status for a project
Inputs: project_key (required), branch.
list_pull_requestsC
List pull requests analyzed for a project
Inputs: project_key (required).
list_quality_gatesA
List all quality gates defined in SonarQube
Inputs: no named parameters.
search_files_by_coverageD
Find files with lowest coverage
Inputs: component (required), page_size, branch.
search_metricsA
List all available metrics in SonarQube
Inputs: no named parameters.
search_security_hotspotsC
Search for security hotspots in a project
Inputs: project_key (required), status, branch.
search_sonar_issuesC
Search for issues (bugs, vulnerabilities, code smells) in a project
Inputs: project_key (required), severities, statuses, page_size, +1 more.
search_sonarqube_projectsC
Search for projects in SonarQube
Inputs: query, page_size.
show_ruleC
Get details of a SonarQube rule
Inputs: rule_key (required).
show_security_hotspotC
Get details of a specific security hotspot
Inputs: hotspot_key (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct aspect of SonarQube (measures, duplications, coverage, quality gates, pull requests, metrics, hotspots, issues, projects, rules). Even similar tools like 'get_file_coverage_details' and 'search_files_by_coverage' have clearly different purposes.
Tools follow a verb_noun pattern (get_, list_, search_, show_) but verbs are mixed inconsistently: 'list' for pull requests and quality gates, 'search' for issues and projects, 'get' for measures and duplications, 'show' for rules and hotspots. While the meaning is clear, unified verb choice would improve consistency.
13 tools is well-scoped for a SonarQube server, covering core inspection and analysis functionalities without being overwhelming. Each tool earns its place.
The set covers key read/query operations (measures, duplications, coverage, quality gates, pull requests, issues, hotspots, projects, rules). Minor gaps exist: no dedicated 'get_issue' or 'get_project' tool for individual details, but search tools provide workarounds.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Web search API and MCP server for developers building AI agents.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server for SonarQube that enables LLM agents to discover projects, analyze code quality metrics, check Quality Gate status, search issues with filters, and rank projects by worst-performing metrics. It provides read-only, safe access to SonarQube instances with structured outputs and error handling.590 PyPI1MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server for interacting with SonarQube code quality platform.31MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that provides AI assistants with access to SonarQube code quality, security, and project analytics data.7115 npmMIT
- FlicenseNot gradedqualityCmaintenanceMCP server that exposes SonarQube data as AI agent tools, enabling project discovery, quality gates, measures, issues, hotspots, rule explanations, source code, and raw API access.4-