Sonarcloud MCP

🚀 SonarCloud MCP Server

A server that offers tools for retrieving SonarCloud issues associated with pull requests.

🚀 Quick Start

The SonarCloud MCP Server is designed to help you fetch issues from SonarCloud related to specific pull requests. Here's an example prompt to get you started:

Fetch the list of OPEN or ACCEPTED issues from sonarcloud for this PR, which are assigned to __me__, fix them and push the changes to this PR.

Note that the __me__ part is a special value in the SonarCloud API, referring to the current user (token owner). You can save this in your .claude/tools folder as sonarcloud-issues.md to quickly request Claude to fetch and fix issues from SonarCloud.

✨ Features

• Retrieve issues from SonarCloud for specific pull requests.
• Filter issues by organization, project, and PR number.
• Support authentication through an API token.
• Return formatted issue data with severity, type, and location information.

📦 Installation

Prerequisite: Generate a SonarCloud API Token

Follow the instructions in the SonarCloud documentation to generate a SonarCloud API token.

Option 1: Docker (Recommended)

# Build the Docker image
npm run docker:build

# Or build directly
docker build -t sonarcloud-mcp .

Option 2: Local Installation

npm ci
npm run build

💻 Usage Examples

Basic Usage - Docker

Run the server via Docker:

docker run -i --rm \
  -e SONARCLOUD_TOKEN=your_token_here \
  -e SONARCLOUD_ORGANISATION=your_organisation_here \
  -e SONARCLOUD_PROJECT_KEY=your_project_key_here \
  sonarcloud-mcp

Basic Usage - Local

Export the required environment variables and run the server:

export SONARCLOUD_TOKEN=your_token_here
export SONARCLOUD_ORGANISATION=your_organisation_here
export SONARCLOUD_PROJECT_KEY=your_project_key_here
npm start

Environment Variables

📚 Documentation

Claude Desktop / Claude Code Integration

Docker Configuration (Recommended)

Add the following to your claude_desktop_config.json or claude.json:

{
  "mcpServers": {
    "sonarcloud": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SONARCLOUD_TOKEN",
        "-e",
        "SONARCLOUD_ORGANISATION",
        "-e",
        "SONARCLOUD_PROJECT_KEY",
        "sonarcloud-mcp"
      ],
      "env": {
        "SONARCLOUD_TOKEN": "<your token here>",
        "SONARCLOUD_ORGANISATION": "<your organisation here>",
        "SONARCLOUD_PROJECT_KEY": "<your project key here>"
      }
    }
  }
}

Local Configuration

Add the following to your claude_desktop_config.json or claude.json:

{
  "mcpServers": {
    "sonarcloud-mcp": {
      "command": "node",
      "args": [
        "/path/to/sonarcloud_mcp/dist/index.js"
      ],
      "env": {
        "SONARCLOUD_TOKEN": "<your token here>",
        "SONARCLOUD_ORGANISATION": "<your organisation here>",
        "SONARCLOUD_PROJECT_KEY": "<your project key here>"
      }
    }
  }
}

Available Tools

• fetch_sonarcloud_issues: Fetches SonarCloud issues for a specific pull request.