sonarqube-mcp-server

# SonarQube MCP Server 基于 Python 开发的 SonarQube MCP Server，支持通过账号密码登录，自动生成 API Token，并支持注册到 Nacos MCP 注册中心。 ## 功能特性 - **账号密码登录**：自动调用 SonarQube API 生成 Token，无需手动配置 Token - **Nacos 注册**：配置 `NACOS_SERVER_ADDR` 后自动注册到 Nacos MCP 注册中心 - **多传输模式**：支持 SSE（Docker/K8s 部署）和 stdio（本地调试） - **Docker/K8s 部署**：完整的容器化部署支持 ## 提供的工具 | 工具 | 说明 | |------|------| | `search_projects` | 搜索 SonarQube 项目 | | `list_project_branches` | 列出项目分支 | | `search_issues` | 搜索 Bug、漏洞、代码异味 | | `search_hotspots` | 搜索安全热点 | | `get_hotspot_detail` | 获取安全热点详情 | | `get_project_measures` | 获取项目质量指标 | | `get_quality_gate_status` | 获取质量门状态 | | `get_source_code` | 获取源代码 | | `search_rules` | 搜索编码规则 | ## 环境变量说明 ### SonarQube 配置 | 变量名 | 必填 | 默认值 | 说明 | |--------|------|--------|------| | `SONARQUBE_URL` | 否 | `https://sonarqube.xiujiadian.com` | SonarQube 服务地址 | | `SONARQUBE_USERNAME` | **是** | - | SonarQube 登录用户名 | | `SONARQUBE_PASSWORD` | **是** | - | SonarQube 登录密码 | ### MCP Server 配置 | 变量名 | 必填 | 默认值 | 说明 | |--------|------|--------|------| | `MCP_SERVICE_NAME` | 否 | `sonarqube-mcp-server` | MCP 服务名称（Nacos 注册名称） | | `MCP_HOST` | 否 | `0.0.0.0` | 监听地址 | | `MCP_PORT` | 否 | `18001` | 监听端口 | | `MCP_TRANSPORT` | 否 | `sse`（有Nacos）/ `stdio`（无Nacos） | 传输模式：`sse` 或 `stdio` | ### Nacos 配置（可选） > 不配置 `NACOS_SERVER_ADDR` 时，服务以标准 FastMCP 模式运行，不注册到 Nacos。 | 变量名 | 必填 | 默认值 | 说明 | |--------|------|--------|------| | `NACOS_SERVER_ADDR` | 否 | - | Nacos 服务地址，如 `192.168.1.100:8848` | | `NACOS_NAMESPACE` | 否 | `public` | Nacos 命名空间 | | `NACOS_USERNAME` | 否 | - | Nacos 用户名（开启鉴权时需要） | | `NACOS_PASSWORD` | 否 | - | Nacos 密码（开启鉴权时需要） | ## 安装 ### 从 PyPI 安装（推荐） ```bash pip install sonarqube-mcp-server # 或使用 uvx 免安装运行 uvx sonarqube-mcp-server ``` ### 从源码安装 ```bash git clone https://github.com/YOUR_USERNAME/sonarqube-mcp-server.git cd sonarqube-mcp-server pip install . ``` ## 快速启动 ### PyPI 安装后使用（stdio 模式） ```bash export SONARQUBE_USERNAME=your_username export SONARQUBE_PASSWORD=your_password sonarqube-mcp-server ``` ### …