MCP-26 Expose a tool to list all supported languages

nquinquenel · nquinquenel · commit e70b31f25e64 · 2025-05-25T13:50:25.000+02:00
diff --git a/README.md b/README.md
@@ -93,6 +93,11 @@ Alternatively, you can manually create or update your VS Code MCP configurations
 
 ## Tools
 
+### Languages
+
+- **list_languages** - List all programming languages supported in this instance
+  - `q` - Optional pattern to match language keys/names against - _String_
+
 ### Issues
 
 - **change_sonar_issue_status** - Change the status of a Sonar issue to "accept", "falsepositive" or to "reopen" an issue
@@ -107,15 +112,6 @@ Alternatively, you can manually create or update your VS Code MCP configurations
 - **search_my_sonarqube_cloud_projects** - Find Sonar projects in my organization
   - `page` - Optional page number - _String_
 
-### Quality Gates
-
-- **get_quality_gate_status_for_project** - Get the Quality Gate Status for the project
-  - `analysisId` - Optional analysis ID - _String_
-  - `branch` - Optional branch key - _String_
-  - `projectId` - Optional project ID - _String_
-  - `projectKey` - Optional project key - _String_
-  - `pullRequest` - Optional pull request ID - _String_
-
 ## Data and telemetry
 
 This server collects anonymous usage data and sends it to SonarSource to help improve the product. No source code or IP address is collected, and SonarSource does not share the data with anyone else. Collection of telemetry can be disabled with the following system property or environment variable: `TELEMETRY_DISABLED=true`. Click [here](telemetry-sample.md) to see a sample of the data that are collected.
diff --git a/src/main/java/org/sonar/mcp/SonarMcpServer.java b/src/main/java/org/sonar/mcp/SonarMcpServer.java
@@ -34,6 +34,7 @@
 import org.sonar.mcp.tools.ToolExecutor;
 import org.sonar.mcp.tools.issues.ChangeIssueStatusTool;
 import org.sonar.mcp.tools.issues.SearchIssuesTool;
+import org.sonar.mcp.tools.languages.ListLanguagesTool;
 import org.sonar.mcp.tools.projects.SearchMyProjectsTool;
 import org.sonar.mcp.tools.qualitygates.ProjectStatusTool;
 
@@ -60,7 +61,8 @@ public SonarMcpServer(StdioServerTransportProvider transportProvider, Map<String
       new ChangeIssueStatusTool(serverApi),
       new SearchMyProjectsTool(serverApi),
       new SearchIssuesTool(serverApi),
-      new ProjectStatusTool(serverApi)
+      new ProjectStatusTool(serverApi),
+      new ListLanguagesTool(serverApi)
     );
   }
 
diff --git a/src/main/java/org/sonar/mcp/serverapi/ServerApi.java b/src/main/java/org/sonar/mcp/serverapi/ServerApi.java
@@ -19,6 +19,7 @@
 import javax.annotation.Nullable;
 import org.sonar.mcp.serverapi.components.ComponentsApi;
 import org.sonar.mcp.serverapi.issues.IssuesApi;
+import org.sonar.mcp.serverapi.languages.LanguagesApi;
 import org.sonar.mcp.serverapi.qualitygates.QualityGatesApi;
 
 public class ServerApi {
@@ -43,6 +44,10 @@ public IssuesApi issuesApi() {
     return new IssuesApi(helper, helper.getOrganization());
   }
 
+  public LanguagesApi languagesApi() {
+    return new LanguagesApi(helper);
+  }
+
   public boolean isAuthenticationSet() {
     return isAuthenticationSet;
   }
diff --git a/src/main/java/org/sonar/mcp/serverapi/languages/LanguagesApi.java b/src/main/java/org/sonar/mcp/serverapi/languages/LanguagesApi.java
@@ -0,0 +1,49 @@
+/*
+ * Sonar MCP Server
+ * Copyright (C) 2025 SonarSource
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the Sonar Source-Available License for more details.
+ *
+ * You should have received a copy of the Sonar Source-Available License
+ * along with this program; if not, see https://sonarsource.com/license/ssal/
+ */
+package org.sonar.mcp.serverapi.languages;
+
+import com.google.gson.Gson;
+import java.util.List;
+import javax.annotation.Nullable;
+import org.sonar.mcp.serverapi.ServerApiHelper;
+import org.sonar.mcp.serverapi.UrlBuilder;
+import org.sonar.mcp.serverapi.languages.response.ListResponse;
+
+public class LanguagesApi {
+
+  public static final String LIST_PATH = "/api/languages/list";
+
+  private final ServerApiHelper helper;
+
+  public LanguagesApi(ServerApiHelper helper) {
+    this.helper = helper;
+  }
+
+  public ListResponse list(@Nullable String query) {
+    try (var response = helper.get(buildListPath(query))) {
+      var responseStr = response.bodyAsString();
+      return new Gson().fromJson(responseStr, ListResponse.class);
+    }
+  }
+
+  private static String buildListPath(@Nullable String query) {
+    return new UrlBuilder(LIST_PATH)
+      .addParam("q", query)
+      .build();
+  }
+
+}
diff --git a/src/main/java/org/sonar/mcp/serverapi/languages/package-info.java b/src/main/java/org/sonar/mcp/serverapi/languages/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Sonar MCP Server
+ * Copyright (C) 2025 SonarSource
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the Sonar Source-Available License for more details.
+ *
+ * You should have received a copy of the Sonar Source-Available License
+ * along with this program; if not, see https://sonarsource.com/license/ssal/
+ */
+@ParametersAreNonnullByDefault
+package org.sonar.mcp.serverapi.languages;
+
+import javax.annotation.ParametersAreNonnullByDefault;
diff --git a/src/main/java/org/sonar/mcp/serverapi/languages/response/ListResponse.java b/src/main/java/org/sonar/mcp/serverapi/languages/response/ListResponse.java
@@ -0,0 +1,26 @@
+/*
+ * Sonar MCP Server
+ * Copyright (C) 2025 SonarSource
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the Sonar Source-Available License for more details.
+ *
+ * You should have received a copy of the Sonar Source-Available License
+ * along with this program; if not, see https://sonarsource.com/license/ssal/
+ */
+package org.sonar.mcp.serverapi.languages.response;
+
+import java.util.List;
+
+public record ListResponse(List<Language> languages) {
+
+  public record Language(String key, String name) {
+  }
+
+}
diff --git a/src/main/java/org/sonar/mcp/serverapi/languages/response/package-info.java b/src/main/java/org/sonar/mcp/serverapi/languages/response/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Sonar MCP Server
+ * Copyright (C) 2025 SonarSource
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the Sonar Source-Available License for more details.
+ *
+ * You should have received a copy of the Sonar Source-Available License
+ * along with this program; if not, see https://sonarsource.com/license/ssal/
+ */
+@ParametersAreNonnullByDefault
+package org.sonar.mcp.serverapi.languages.response;
+
+import javax.annotation.ParametersAreNonnullByDefault;
diff --git a/src/main/java/org/sonar/mcp/tools/languages/ListLanguagesTool.java b/src/main/java/org/sonar/mcp/tools/languages/ListLanguagesTool.java
@@ -0,0 +1,63 @@
+/*
+ * Sonar MCP Server
+ * Copyright (C) 2025 SonarSource
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the Sonar Source-Available License for more details.
+ *
+ * You should have received a copy of the Sonar Source-Available License
+ * along with this program; if not, see https://sonarsource.com/license/ssal/
+ */
+package org.sonar.mcp.tools.languages;
+
+import org.sonar.mcp.serverapi.ServerApi;
+import org.sonar.mcp.serverapi.languages.response.ListResponse;
+import org.sonar.mcp.tools.SchemaToolBuilder;
+import org.sonar.mcp.tools.Tool;
+
+public class ListLanguagesTool extends Tool {
+
+  public static final String TOOL_NAME = "list_languages";
+  public static final String QUERY_PROPERTY = "q";
+
+  private final ServerApi serverApi;
+
+  public ListLanguagesTool(ServerApi serverApi) {
+    super(new SchemaToolBuilder()
+      .setName(TOOL_NAME)
+      .setDescription("List all programming languages supported in this instance")
+      .addStringProperty(QUERY_PROPERTY, "Optional pattern to match language keys/names against")
+      .build());
+    this.serverApi = serverApi;
+  }
+
+  @Override
+  public Tool.Result execute(Tool.Arguments arguments) {
+    if (!serverApi.isAuthenticationSet()) {
+      return Tool.Result.failure("Not connected to SonarQube Cloud, please provide 'SONARQUBE_CLOUD_TOKEN' and 'SONARQUBE_CLOUD_ORG'");
+    }
+
+    var query = arguments.getOptionalString(QUERY_PROPERTY);
+    var response = serverApi.languagesApi().list(query);
+    return Tool.Result.success(buildResponseFromList(response));
+  }
+
+  private static String buildResponseFromList(ListResponse response) {
+    var stringBuilder = new StringBuilder();
+    stringBuilder.append("Supported Languages:\n\n");
+
+    for (var language : response.languages()) {
+      stringBuilder.append(language.name())
+        .append(" (").append(language.key()).append(")")
+        .append("\n");
+    }
+
+    return stringBuilder.toString().trim();
+  }
+} 
diff --git a/src/main/java/org/sonar/mcp/tools/languages/package-info.java b/src/main/java/org/sonar/mcp/tools/languages/package-info.java
@@ -0,0 +1,20 @@
+/*
+ * Sonar MCP Server
+ * Copyright (C) 2025 SonarSource
+ * mailto:info AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the Sonar Source-Available License Version 1, as published by SonarSource SA.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ * See the Sonar Source-Available License for more details.
+ *
+ * You should have received a copy of the Sonar Source-Available License
+ * along with this program; if not, see https://sonarsource.com/license/ssal/
+ */
+@ParametersAreNonnullByDefault
+package org.sonar.mcp.tools.languages;
+
+import javax.annotation.ParametersAreNonnullByDefault;
diff --git a/src/test/java/org/sonar/mcp/tools/languages/ListLanguagesToolTests.java b/src/test/java/org/sonar/mcp/tools/languages/ListLanguagesToolTests.java
