Skip to main content
Glama
akhilthomas236

SonarQube MCP Server

SonarQube MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to SonarQube code quality, security, and project analytics data.

npm version License: MIT

Features

  • Project Listing: Get comprehensive project information with quality metrics

  • Project Metrics: Fetch detailed quality metrics including coverage, duplication, maintainability

  • Issue Management: List and analyze code quality issues with filtering capabilities

  • Security Analysis: Get detailed security vulnerability and hotspot information

  • Quality Gates: Check quality gate status and conditions

  • Historical Analysis: View project evolution and quality trends over time

Related MCP server: sonarqube-mcp

Installation

# Global installation
npm install -g mcp-sonarqube

# Local installation in your project
npm install mcp-sonarqube

From Source

  1. Clone the repository:

git clone https://github.com/akhilthomas236/sonarqube-mcp-npm.git
cd sonarqube-mcp
  1. Install dependencies:

npm install
  1. Build the project:

npm run build

Quick Start

1. Install the package

npm install -g mcp-sonarqube

2. Set up environment variables

export SONARQUBE_URL="http://your-sonarqube-instance:9000"
export SONARQUBE_TOKEN="your-sonarqube-token"

3. Run as MCP Server

mcp-sonarqube

4. VS Code Integration

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "sonarqube": {
      "command": "npx",
      "args": ["mcp-sonarqube"],
      "env": {
        "SONARQUBE_URL": "http://localhost:9000",
        "SONARQUBE_TOKEN": "your-sonarqube-token-here"
      }
    }
  }
}

Then use with GitHub Copilot:

@copilot List all projects in our SonarQube instance
@copilot Show me quality metrics for project "my-app"
@copilot What are the critical security vulnerabilities in project "api-service"?

Getting a SonarQube Token

  1. Log in to your SonarQube instance

  2. Go to User > My Account > Security

  3. Generate a new token with appropriate permissions

  4. Use this token as your SONARQUBE_TOKEN

Usage

Running the Server

npm start

The server runs on stdio transport and communicates via the Model Context Protocol.

Available Tools

1. list_projects

Lists all projects in your SonarQube instance with key metrics.

Parameters:

  • search (optional): Filter projects by name or key

  • qualityGate (optional): Filter by quality gate status (OK, WARN, ERROR)

  • organization (optional): Filter by organization (SonarCloud)

2. get_project_metrics

Get comprehensive metrics for a specific project.

Parameters:

  • projectKey (required): The SonarQube project key

  • branch (optional): Branch name (defaults to main branch)

  • metrics (optional): Comma-separated list of specific metrics

3. list_issues

List code quality issues with filtering options.

Parameters:

  • projectKey (required): The SonarQube project key

  • branch (optional): Branch name

  • types (optional): Issue types (BUG, VULNERABILITY, CODE_SMELL)

  • severities (optional): Severities (BLOCKER, CRITICAL, MAJOR, MINOR, INFO)

  • statuses (optional): Statuses (OPEN, CONFIRMED, REOPENED, RESOLVED, CLOSED)

  • assignees (optional): Assignee usernames

  • tags (optional): Issue tags

  • limit (optional): Maximum number of issues (default: 50)

4. get_security_vulnerabilities

Get detailed security vulnerability analysis.

Parameters:

  • projectKey (required): The SonarQube project key

  • branch (optional): Branch name

  • severities (optional): Filter by severities

  • statuses (optional): Filter by statuses

  • assigned (optional): Filter by assigned/unassigned

  • limit (optional): Maximum number of vulnerabilities (default: 50)

5. get_quality_gate

Check quality gate status and conditions.

Parameters:

  • projectKey (required): The SonarQube project key

  • branch (optional): Branch name

6. get_analysis_history

View historical analysis data and trends.

Parameters:

  • projectKey (required): The SonarQube project key

  • branch (optional): Branch name

  • from (optional): Start date (YYYY-MM-DD)

  • to (optional): End date (YYYY-MM-DD)

  • limit (optional): Maximum number of analyses (default: 10)

Development

Project Structure

src/
├── index.ts                    # MCP server entry point
├── services/
│   └── sonarqube-client.ts    # SonarQube API client
├── tools/                     # MCP tool implementations
│   ├── list-projects.ts
│   ├── get-project-metrics.ts
│   ├── list-issues.ts
│   ├── get-security-vulnerabilities.ts
│   ├── get-quality-gate.ts
│   └── get-analysis-history.ts
├── types/
│   └── sonarqube.ts          # TypeScript type definitions
└── utils/
    └── formatting.ts         # Utility functions

Scripts

  • npm run build - Build the TypeScript project

  • npm run dev - Run in development mode with ts-node

  • npm start - Start the MCP server

  • npm test - Run tests

Adding New Tools

  1. Create a new tool file in src/tools/

  2. Implement the tool schema and handler function

  3. Add the tool to the imports and tools array in src/index.ts

  4. Add a case for the tool in the CallTool handler

VS Code Integration

To use this MCP server with VS Code and Copilot:

  1. Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "sonarqube": {
      "command": "npx",
      "args": ["mcp-sonarqube"],
      "env": {
        "SONARQUBE_URL": "http://localhost:9000",
        "SONARQUBE_TOKEN": "your-token-here"
      }
    }
  }
}

Method 2: Using local installation

If you have the package installed locally:

{
  "servers": {
    "sonarqube": {
      "command": "node",
      "args": ["./node_modules/mcp-sonarqube/dist/index.js"],
      "env": {
        "SONARQUBE_URL": "http://localhost:9000",
        "SONARQUBE_TOKEN": "your-token-here"
      }
    }
  }
}

Method 3: Global installation

If you have the package installed globally:

{
  "servers": {
    "sonarqube": {
      "command": "mcp-sonarqube",
      "env": {
        "SONARQUBE_URL": "http://localhost:9000",
        "SONARQUBE_TOKEN": "your-token-here"
      }
    }
  }
}
  1. Install the MCP extension for VS Code

  2. The SonarQube tools will be available in Copilot Chat

Examples

Check Project Quality

@copilot Use the SonarQube tools to give me a quality overview of project "my-app"

Security Analysis

@copilot Show me all security vulnerabilities in project "my-app" that are CRITICAL or BLOCKER

Quality Gate Status

@copilot Check if project "my-app" passes its quality gate
@copilot Show me the quality trends for project "my-app" over the last month

Error Handling

The server provides detailed error messages for common issues:

  • Missing environment variables

  • Invalid project keys

  • SonarQube connection issues

  • Authentication failures

  • Invalid parameters

Troubleshooting

"Server exited before responding to initialize request"

If you encounter this error in VS Code or when using the MCP server, try these solutions:

  1. Test the server directly first:

    # Test if the server starts correctly
    node dist/index.js
    # Should output: "SonarQube MCP Server started successfully"
    
    # Test with an MCP initialize request
    echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | node dist/index.js
  2. For VS Code integration issues:

    • Make sure the package is installed globally: npm install -g mcp-sonarqube

    • Try using the full path instead of npx:

      {
        "servers": {
          "sonarqube": {
            "command": "node",
            "args": ["/path/to/global/node_modules/mcp-sonarqube/dist/index.js"],
            "env": {
              "SONARQUBE_URL": "http://localhost:9000",
              "SONARQUBE_TOKEN": "your-token"
            }
          }
        }
      }
    • Restart VS Code after changing the MCP configuration

  3. For npx issues:

    • Clear npm cache: npm cache clean --force

    • Reinstall the package: npm uninstall -g mcp-sonarqube && npm install -g mcp-sonarqube

    • Check Node.js version (requires Node.js 18+)

  4. Environment variable issues:

    • Ensure SONARQUBE_URL and SONARQUBE_TOKEN are properly set

    • Test connection: curl -u your-token: $SONARQUBE_URL/api/projects/search

SonarQube API Parameter Errors

If you encounter API errors related to invalid parameters:

  1. "additionalFields components must be one of..."

    • This error has been fixed in version 1.0.2+

    • Update to the latest version: npm update -g mcp-sonarqube

    • The server now uses valid additionalFields values: rules,users,comments

  2. Invalid parameter values:

    • Check that your SonarQube version supports the API endpoints being used

    • Some parameters may have different valid values in different SonarQube versions

    • Refer to your SonarQube instance's API documentation at: {SONARQUBE_URL}/web_api

Network and Authentication Issues

  1. Connection errors:

    • Verify SonarQube URL is accessible

    • Check firewall settings

    • Ensure SonarQube server is running

  2. Authentication errors:

    • Verify token is valid and has appropriate permissions

    • Check token expiration

    • Ensure token has at least "Browse" permission on projects

  3. SSL/TLS issues:

    • For self-signed certificates, you may need to set NODE_TLS_REJECT_UNAUTHORIZED=0 (not recommended for production)

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Submit a pull request

License

MIT License - see LICENSE file for details

Support

For issues and questions:

  1. Check the SonarQube API documentation

  2. Verify your token permissions

  3. Ensure network connectivity to SonarQube

  4. Check the server logs for detailed error messages

  5. Create an issue on GitHub

Available Tools

7 tools
get_analysis_historyB

Get historical analysis data and trends for a SonarQube project

ParametersJSON Schema
NameRequiredDescriptionDefault
projectKeyYesThe SonarQube project key
branchNoBranch name (optional, defaults to main branch)
fromNoStart date for analysis history (YYYY-MM-DD format)
toNoEnd date for analysis history (YYYY-MM-DD format)
limitNoMaximum number of analyses to return (default: 10)

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, placing full burden on the description. It only states the purpose without disclosing behavioral traits such as read-only nature, pagination, or any side effects. Minimal transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with a single sentence, no unnecessary words. However, it lacks structure like separate sections or usage notes, but still efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 5 parameters and no output schema, the description does not explain return values, how trends are represented, or how to interpret the data. The agent would lack context to use the output effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with detailed parameter descriptions. The tool description adds no additional meaning beyond the schema, so baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Get' and the resource 'historical analysis data and trends for a SonarQube project', which is distinct from sibling tools like get_project_repository or list_issues.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for retrieving historical analysis and trends, but lacks explicit guidance on when to use versus alternatives or conditions like requiring a projectKey. No exclusion criteria provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_project_repositoryB

Get git repository information and source code management details for a SonarQube project

ParametersJSON Schema
NameRequiredDescriptionDefault
projectKeyYesThe SonarQube project key (required)
includeBranchesNoInclude branch information in the response (optional, default: false)

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description must carry full burden. Only states retrieval but no details on side effects, permissions, or read-only nature. Minimal behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, 15 words, no redundancy. Efficiently communicates purpose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Simple tool with two parameters and no output schema. Description is adequate but could mention return format or typical usage. No major gaps but not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema covers both parameters fully, so baseline is 3. Description provides context but adds no extra semantic information beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clear verb 'Get' and specific resource 'git repository information and source code management details' for a SonarQube project. Distinguishes from siblings like get_analysis_history or list_issues.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool vs alternatives. Lacks context or exclusions that help the agent decide.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_quality_gateB

Get quality gate status and conditions for a SonarQube project

ParametersJSON Schema
NameRequiredDescriptionDefault
projectKeyYesThe SonarQube project key
branchNoBranch name (optional, defaults to main branch)

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It does not disclose behavioral traits such as read-only nature, required authentication, error handling, or any side effects. The minimal description leaves an AI agent to infer behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence that directly states the purpose. It is front-loaded with the key action and resource.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the simple tool with 2 parameters (both well-described in schema) and no output schema, the description is reasonably complete. It could mention the type of conditions returned, but it suffices for a straightforward getter.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the description does not need to add much. It adds no extra meaning beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Get quality gate status and conditions for a SonarQube project' clearly states the verb (Get) and resource (quality gate status and conditions). It differentiates from sibling tools like get_analysis_history and get_security_vulnerabilities by focusing on quality gates.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, no prerequisites, and no conditions under which it should not be used.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_security_vulnerabilitiesC

Get detailed security vulnerability analysis from a SonarQube project

ParametersJSON Schema
NameRequiredDescriptionDefault
projectKeyYesThe SonarQube project key
branchNoBranch name (optional, defaults to main branch)
severitiesNoComma-separated severities (BLOCKER, CRITICAL, MAJOR, MINOR, INFO)
statusesNoComma-separated statuses (OPEN, CONFIRMED, REOPENED, RESOLVED, CLOSED)
assignedNoFilter by assigned/unassigned vulnerabilities
limitNoMaximum number of vulnerabilities to return (default: 50)

TDQS

C2.9/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description provides no insight into behavior beyond the name. No mention of read-only nature, response details, or any side effects. Without annotations, this is insufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence, no wasted words, but could benefit from a brief example or usage hint without being verbose.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema, no annotations, and a terse description. The tool has 6 parameters and multiple filter options, yet the description does not explain what the analysis includes or how results are structured.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the description adds no additional meaning beyond parameter names and schema descriptions. Baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it retrieves security vulnerability analysis from SonarQube, but does not explicitly distinguish it from sibling tools like 'list_issues' or 'sonarqube_get_project_metrics'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives (e.g., for general issues vs. security-specific). No information on prerequisites or context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_issuesB

List code quality issues from a SonarQube project with filtering options

ParametersJSON Schema
NameRequiredDescriptionDefault
projectKeyYesThe SonarQube project key
branchNoBranch name (optional, defaults to main branch)
typesNoComma-separated issue types (BUG, VULNERABILITY, CODE_SMELL)
severitiesNoComma-separated severities (BLOCKER, CRITICAL, MAJOR, MINOR, INFO)
statusesNoComma-separated statuses (OPEN, CONFIRMED, REOPENED, RESOLVED, CLOSED)
assigneesNoComma-separated assignee usernames
tagsNoComma-separated tags
limitNoMaximum number of issues to return (default: 50)

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must disclose behavioral traits. It only says 'list', implying read-only, but does not explicitly state that no data is modified, nor does it mention authentication, rate limits, or pagination behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence of 10 words, concise and front-loaded with the core purpose. Every word contributes.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 8 parameters, no output schema, and no annotations, the description is too minimal. It lacks information on output format, pagination, defaults (e.g., limit default 50), or any behavioral context beyond listing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage (all 8 parameters have descriptions). The tool description adds no additional meaning beyond 'with filtering options', which is already implied by the parameter descriptions. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'List code quality issues from a SonarQube project with filtering options', providing a specific verb ('list') and resource ('code quality issues from a SonarQube project'). It distinguishes itself from sibling tools like get_security_vulnerabilities or get_analysis_history by focusing on general issues.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance is provided on when to use this tool versus alternatives. Sibling tools are listed but no comparisons or contexts are given, leaving the agent to infer usage without clear decision criteria.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sonarqube_get_project_metricsA

Retrieve comprehensive project quality metrics including coverage, technical debt, complexity, and issue counts

ParametersJSON Schema
NameRequiredDescriptionDefault
projectKeyYesSonarQube project key (required)
branchNoSpecific branch to analyze (optional, defaults to main branch)
metricsNoComma-separated list of specific metrics to retrieve (optional, defaults to standard quality metrics)

TDQS

A3.5/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It does not disclose side effects (assuming read-only), authentication needs, rate limits, or any behavioral traits beyond retrieving data. Minimal disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single sentence that is front-loaded with purpose and examples; no unnecessary words. Efficient and to the point.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

No output schema, so description should explain return values better. It lists example metrics but does not specify output format, error cases, or how to interpret results. Adequate but not thorough for a metrics retrieval tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The tool description adds value by listing example metrics, but does not explain the format or constraints of the optional metrics parameter beyond what is in the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states it retrieves comprehensive quality metrics and lists specific examples (coverage, technical debt, complexity, issue counts), which distinguishes it from sibling tools that focus on specific areas like security vulnerabilities or analysis history.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool versus alternatives, but the focus on general metrics is implied by the description and sibling tool names. Lacks explicit when-not-to-use or context for selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

sonarqube_list_projectsB

List all accessible SonarQube projects with their basic information and quality status

ParametersJSON Schema
NameRequiredDescriptionDefault
organizationNoFilter projects by organization (optional)
searchNoSearch term to filter project names (optional)
qualityGateNoFilter by quality gate status: OK, WARN, ERROR (optional)

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description should disclose behavioral traits. It only states the basic function without mentioning read-only nature, permission requirements, or any side effects. This is insufficient for an agent to assess safety.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, efficient sentence of 12 words. It is front-loaded with the key action and resource, achieving conciseness without losing clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple listing tool with no output schema, the description covers the essential purpose and available filters. It lacks pagination info but remains adequate for basic use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description does not add any meaning beyond the schema's parameter descriptions, which are already clear.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'list', resource 'SonarQube projects', and output 'basic information and quality status'. It effectively distinguishes this tool from siblings like 'list_issues' and 'get_quality_gate' by focusing on project listing.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when or when not to use this tool, nor does it mention alternatives among siblings. Users are left to infer from context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 7 tool updatesv1.1.1
    • First observedget_analysis_history
    • First observedget_project_repository
    • First observedget_quality_gate
    • First observedget_security_vulnerabilities
    • First observedlist_issues
    • First observedsonarqube_get_project_metrics
    • First observedsonarqube_list_projects

TDQS

A3.5/5.0
Disambiguation5/5

Each tool targets a distinct SonarQube resource: project listing, metrics, quality gate, issues, security vulnerabilities, analysis history, and repository info. No overlap in purpose.

Naming Consistency3/5

Most tools use verb_noun snake_case (e.g., get_analysis_history), but two tools include a 'sonarqube_' prefix (sonarqube_get_project_metrics, sonarqube_list_projects), breaking the pattern. The convention is mixed but still readable.

Tool Count5/5

7 tools is well-scoped for a SonarQube analysis server, covering the primary read operations without redundancy.

Completeness4/5

Covers major reading operations (metrics, issues, security, quality gate), but misses some likely endpoints like 'get_project' for a single project or 'get_issue' for a specific issue. Minor gaps that agents can work around.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    A read-only MCP server that provides AI assistants with structured access to SonarQube projects, issues, metrics, and rules. It enables safe analysis of code quality and security findings through a set of validated, safety-first tools.
    6
    -
  • A
    license
    A
    quality
    B
    maintenance
    An 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.
    5
    MIT
  • A
    license
    C
    quality
    C
    maintenance
    A Python MCP server for SonarQube, enabling AI agents to query projects, issues, quality gates, coverage, and security hotspots.
    13
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/akhilthomas236/sonarqube-mcp-npm'

If you have feedback or need assistance with the MCP directory API, please join our Discord server