SonarCloud MCP Server

Instructions

Implementation Reference

• src/index.ts:605-645 (handler)

  The core handler function that implements the 'summarize_sonarcloud_issues' tool logic. It fetches detailed issues using the internal fetchSonarCloudIssues method, processes them to create counts by severity, type, status, debt, top rules, and affected files, then returns a JSON summary.

  private async summarizeSonarCloudIssues(args: any): Promise<any> {
    // Get the raw issues first
    const issuesResponse = await this.fetchSonarCloudIssues({
      ...args,
      additionalFields: ["_all"],
      facets: ["issueStatuses", "impactSeverities", "types", "rules"],
      ps: 500 // Get more issues for better summary
    });
    
    const data = JSON.parse(issuesResponse.content[0].text);
    const issues = data.issues;
    
    // Create summary
    const summary: IssueSummary = {
      totalIssues: data.summary.total,
      criticalIssues: issues.filter((i: any) => i.severity === "BLOCKER").length,
      highImpactIssues: issues.filter((i: any) => i.severity === "CRITICAL" || i.severity === "MAJOR").length,
      mediumImpactIssues: issues.filter((i: any) => i.severity === "MINOR").length,
      lowImpactIssues: issues.filter((i: any) => i.severity === "INFO").length,
      infoIssues: issues.filter((i: any) => i.severity === "INFO").length,
      bugCount: issues.filter((i: any) => i.type === "BUG").length,
      vulnerabilityCount: issues.filter((i: any) => i.type === "VULNERABILITY").length,
      codeSmellCount: issues.filter((i: any) => i.type === "CODE_SMELL").length,
      securityHotspotCount: issues.filter((i: any) => i.type === "SECURITY_HOTSPOT").length,
      openIssues: issues.filter((i: any) => i.status === "OPEN").length,
      confirmedIssues: issues.filter((i: any) => i.status === "CONFIRMED").length,
      totalDebt: data.debtTotal?.toString() || "0",
      totalEffort: data.effortTotal?.toString() || "0",
      topRules: this.getTopRules(issues),
      filesAffected: new Set(issues.map((i: any) => i.component)).size,
    };
    
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(summary, null, 2),
        },
      ],
    };
  }

• src/index.ts:351-387 (schema)

  The input schema defining the parameters for the 'summarize_sonarcloud_issues' tool, including pullRequest, token, impactSeverities, sinceLeakPeriod, and issueStatuses.

  type: "object",
  properties: {
    pullRequest: {
      type: "string",
      description: "Pull request id",
    },
    token: {
      type: "string",
      description: "SonarCloud API token (optional if set in environment)",
    },
    impactSeverities: {
      type: "array",
      items: {
        type: "string",
        enum: ["INFO", "LOW", "MEDIUM", "HIGH", "BLOCKER"],
      },
      description: "Comma-separated list of impact severities.",
    },
    sinceLeakPeriod: {
      type: "boolean",
      description: "To retrieve issues created since the leak period. If this parameter is set to a truthy value, createdAfter must not be set and one component id or key must be provided. (default: false)",
    },
    issueStatuses: {
      type: "array",
      items: {
        type: "string",
        enum: [
          "OPEN",
          "CONFIRMED",
          "FALSE_POSITIVE",
          "ACCEPTED",
          "FIXED",
        ],
      },
      description: "Comma-separated list of issue statuses",
    },
  },

• src/index.ts:402-403 (registration)

  Registration of the tool in the main request handler dispatch logic, mapping the tool name to its handler method.

  if (name === "summarize_sonarcloud_issues") {
    return await this.summarizeSonarCloudIssues(args);

• src/index.ts:347-390 (registration)

  Tool definition and registration in the tools list, including name, description, and input schema for MCP tool discovery.

  {
    name: "summarize_sonarcloud_issues",
    description: "Get a high-level summary of SonarCloud issues for a PR",
    inputSchema: {
      type: "object",
      properties: {
        pullRequest: {
          type: "string",
          description: "Pull request id",
        },
        token: {
          type: "string",
          description: "SonarCloud API token (optional if set in environment)",
        },
        impactSeverities: {
          type: "array",
          items: {
            type: "string",
            enum: ["INFO", "LOW", "MEDIUM", "HIGH", "BLOCKER"],
          },
          description: "Comma-separated list of impact severities.",
        },
        sinceLeakPeriod: {
          type: "boolean",
          description: "To retrieve issues created since the leak period. If this parameter is set to a truthy value, createdAfter must not be set and one component id or key must be provided. (default: false)",
        },
        issueStatuses: {
          type: "array",
          items: {
            type: "string",
            enum: [
              "OPEN",
              "CONFIRMED",
              "FALSE_POSITIVE",
              "ACCEPTED",
              "FIXED",
            ],
          },
          description: "Comma-separated list of issue statuses",
        },
      },
      required: [],
    },
  },

• src/index.ts:647-657 (helper)

  Helper function used by the handler to compute the top 10 most frequent rules in the issues for the summary.

  private getTopRules(issues: any[]): Array<{rule: string; count: number}> {
    const ruleCounts = issues.reduce((acc, issue) => {
      acc[issue.rule] = (acc[issue.rule] || 0) + 1;
      return acc;
    }, {} as Record<string, number>);
    
    return Object.entries(ruleCounts)
      .sort(([,a], [,b]) => (b as number) - (a as number))
      .slice(0, 10)
      .map(([rule, count]) => ({rule, count: count as number}));
  }