Sonarcloud MCP

🚀 SonarCloud MCP Server

SonarCloud MCP Server 是一個 MCP 服務器，它提供了用於獲取與拉取請求（PR）相關的 SonarCloud 問題的工具。通過該工具，你可以方便地獲取特定 PR 的問題信息，助力代碼質量的提升。

🚀 快速開始

使用 SonarCloud MCP Server 前，你需要先了解其基本功能和使用方式。它能幫助你從 SonarCloud 中獲取特定拉取請求的問題，並進行篩選和處理。

✨ 主要特性

• 為特定的拉取請求從 SonarCloud 獲取問題。
• 可按組織、項目和 PR 編號進行篩選。
• 支持通過 API 令牌進行身份驗證。
• 返回包含嚴重性、類型和位置信息的格式化問題數據。

📦 安裝指南

前提條件：生成 SonarCloud API 令牌

請按照 SonarCloud 文檔 中的說明生成 SonarCloud API 令牌。

選項 1：Docker（推薦）

# 構建 Docker 鏡像
npm run docker:build

# 或者直接構建
docker build -t sonarcloud-mcp .

選項 2：本地安裝

npm ci
npm run build

💻 使用示例

Docker 使用方法

通過 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

本地使用方法

導出所需的環境變量並運行服務器：

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

環境變量說明

• SONARCLOUD_TOKEN：你的 SonarCloud API 令牌（必需）。
• SONARCLOUD_ORGANISATION：你的 SonarCloud 組織密鑰（可選，可以作為參數傳遞）。
• SONARCLOUD_PROJECT_KEY：你的 SonarCloud 項目密鑰（可選，可以作為參數傳遞）。

📚 詳細文檔

Claude Desktop / Claude Code 集成

Docker 配置（推薦）

在你的 claude_desktop_config.json 或 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>"
      }
    }
  }
}

本地配置

在你的 claude_desktop_config.json 或 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>"
      }
    }
  }
}

可用工具

• fetch_sonarcloud_issues：為特定的拉取請求獲取 SonarCloud 問題。