dragonhold2024/sonarqube-mcp

SonarQube MCP服务器

镜像概述

这是一个Model Context Protocol（MCP）服务器，提供对SonarQube代码质量和安全分析能力的全面访问，支持Claude等AI助手与SonarQube交互，实现代码审查、安全漏洞管理及质量门监控等功能。

核心功能

• 覆盖SonarQube API的30+工具类别
• 安全热点：审查和管理代码安全漏洞
• 问题管理：搜索、筛选和处理代码质量问题
• 质量门：检查和管理项目质量门状态
• 质量配置文件：管理规则配置与自定义
• 规则库：搜索和管理代码分析规则
• 项目管理：创建、配置和维护SonarQube项目
• 分支与PR分析：评估分支和拉取请求的质量
• 指标度量：获取代码复杂度、覆盖率等关键指标
• 用户权限：管理用户、组及访问权限
• ALM集成：支持GitHub、GitLab等主流代码仓库平台
• 扩展功能：组件管理、重复代码检测、通知设置等

配置说明

工具层级说明

创建SonarQube令牌步骤

1. 登录SonarQube实例
2. 进入我的账户 → 安全页面
3. 生成新令牌并设置合适的权限
4. 复制令牌值用于配置

集成示例

与Claude Desktop集成

选项1：Docker部署（推荐）

在claude_desktop_config.json中添加配置：

json
{
  "mcpServers": {
    "sonarqube": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SONARQUBE_TOKEN",
        "-e", "SONARQUBE_URL",
        "-e", "SONARQUBE_TOOLS",
        "dragonhold2024/sonarqube-mcp:latest"
      ],
      "env": {
        "SONARQUBE_URL": "https://sonar.example.com",
        "SONARQUBE_TOKEN": "your-token",
        "SONARQUBE_TOOLS": "standard"
      }
    }
  }
}

选项2：本地Node.js运行

bash
git clone https://git.ci.dragonhold.org/Dragonhold2024/sonarqube-mcp.git
cd sonarqube-mcp
npm install && npm run build

在claude_desktop_config.json中添加：

json
{
  "mcpServers": {
    "sonarqube": {
      "command": "node",
      "args": ["/path/to/sonarqube-mcp/dist/index.js"],
      "env": {
        "SONARQUBE_URL": "https://sonar.example.com",
        "SONARQUBE_TOKEN": "your-token"
      }
    }
  }
}

与Claude Code集成

通过命令行添加配置：

bash
claude mcp add sonarqube \
  docker run -i --rm \
  -e SONARQUBE_TOKEN \
  -e SONARQUBE_URL \
  docker.xuanyuan.run/dragonhold2024/sonarqube-mcp:latest

或直接修改设置（使用admin层级）：

json
{
  "mcpServers": {
    "sonarqube": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SONARQUBE_TOKEN",
        "-e", "SONARQUBE_URL",
        "-e", "SONARQUBE_TOOLS",
        "dragonhold2024/sonarqube-mcp:latest"
      ],
      "env": {
        "SONARQUBE_URL": "https://sonar.example.com",
        "SONARQUBE_TOKEN": "your-token",
        "SONARQUBE_TOOLS": "admin"
      }
    }
  }
}

可用工具（部分）

完整工具列表请参考源代码。

开发指南

前提条件

• Node.js ≥ 20.0.0
• npm包管理工具

本地构建

bash
npm install
npm run build

测试与质量检查

bash
npm test                  # 运行单元测试
npm run test:coverage     # 生成测试覆盖率报告
npm run lint              # ESLint代码检查
npm run typecheck         # TypeScript类型验证

许可证

MIT

贡献

欢迎提交Pull Request参与项目改进！