You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by ac...@apache.org on 2026/02/10 12:37:52 UTC

(camel) 01/01: CAMEL-22976 - Camel-jbang-MCP: Add doc tool for dataformat and language too

This is an automated email from the ASF dual-hosted git repository.

acosentino pushed a commit to branch CAMEL-22976
in repository https://gitbox.apache.org/repos/asf/camel.git

commit bca7c83e6197f5cffa932b6793413aa141c021e2
Author: Andrea Cosentino <an...@gmail.com>
AuthorDate: Tue Feb 10 13:37:01 2026 +0100

    CAMEL-22976 - Camel-jbang-MCP: Add doc tool for dataformat and language too
    
    Signed-off-by: Andrea Cosentino <an...@gmail.com>
---
 .../modules/ROOT/pages/camel-jbang-mcp.adoc        |  10 +-
 .../dsl/jbang/core/commands/mcp/CatalogTools.java  | 102 +++++++++++++++++++++
 2 files changed, 111 insertions(+), 1 deletion(-)

diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc b/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
index a1d7c1089fc6..0aa2857fb6b0 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
@@ -24,7 +24,7 @@ By default, the HTTP server is disabled. To enable it, set `quarkus.http.host-en
 
 == Available Tools
 
-The server exposes 13 tools organized into six functional areas.
+The server exposes 15 tools organized into six functional areas.
 
 === Catalog Exploration
 
@@ -43,9 +43,17 @@ The server exposes 13 tools organized into six functional areas.
 | `camel_catalog_dataformats`
 | List available data formats (JSON, XML, CSV, Avro, Protobuf, and others).
 
+| `camel_catalog_dataformat_doc`
+| Get detailed documentation for a specific data format including all configuration options, Maven coordinates,
+  and model information.
+
 | `camel_catalog_languages`
 | List expression languages (Simple, JsonPath, XPath, JQ, Groovy, and others).
 
+| `camel_catalog_language_doc`
+| Get detailed documentation for a specific expression language including all configuration options and
+  Maven coordinates.
+
 | `camel_catalog_eips`
 | List Enterprise Integration Patterns with filtering by category.
 
diff --git a/dsl/camel-jbang/camel-jbang-mcp/src/main/java/org/apache/camel/dsl/jbang/core/commands/mcp/CatalogTools.java b/dsl/camel-jbang/camel-jbang-mcp/src/main/java/org/apache/camel/dsl/jbang/core/commands/mcp/CatalogTools.java
index 29f813da9014..374e8028bcbf 100644
--- a/dsl/camel-jbang/camel-jbang-mcp/src/main/java/org/apache/camel/dsl/jbang/core/commands/mcp/CatalogTools.java
+++ b/dsl/camel-jbang/camel-jbang-mcp/src/main/java/org/apache/camel/dsl/jbang/core/commands/mcp/CatalogTools.java
@@ -156,6 +156,46 @@ public class CatalogTools {
         }
     }
 
+    /**
+     * Tool to get detailed documentation for a specific data format.
+     */
+    @Tool(description = "Get detailed documentation for a Camel data format including all options, "
+                        + "Maven coordinates, and configuration parameters.")
+    public DataFormatDetailResult camel_catalog_dataformat_doc(
+            @ToolArg(description = "Data format name (e.g., json-jackson, avro, csv, protobuf, jaxb)") String dataformat) {
+
+        if (dataformat == null || dataformat.isBlank()) {
+            throw new ToolCallException("Data format name is required", null);
+        }
+
+        DataFormatModel model = catalog.dataFormatModel(dataformat);
+        if (model == null) {
+            throw new ToolCallException("Data format not found: " + dataformat, null);
+        }
+
+        return toDataFormatDetailResult(model);
+    }
+
+    /**
+     * Tool to get detailed documentation for a specific expression language.
+     */
+    @Tool(description = "Get detailed documentation for a Camel expression language including all options, "
+                        + "Maven coordinates, and configuration parameters.")
+    public LanguageDetailResult camel_catalog_language_doc(
+            @ToolArg(description = "Language name (e.g., simple, jsonpath, xpath, jq, groovy)") String language) {
+
+        if (language == null || language.isBlank()) {
+            throw new ToolCallException("Language name is required", null);
+        }
+
+        LanguageModel model = catalog.languageModel(language);
+        if (model == null) {
+            throw new ToolCallException("Language not found: " + language, null);
+        }
+
+        return toLanguageDetailResult(model);
+    }
+
     /**
      * Tool to list EIPs (Enterprise Integration Patterns).
      */
@@ -361,6 +401,58 @@ public class CatalogTools {
                 options);
     }
 
+    private DataFormatDetailResult toDataFormatDetailResult(DataFormatModel model) {
+        List<OptionInfo> options = new ArrayList<>();
+        if (model.getOptions() != null) {
+            model.getOptions().forEach(opt -> options.add(new OptionInfo(
+                    opt.getName(),
+                    opt.getDescription(),
+                    opt.getType(),
+                    opt.isRequired(),
+                    opt.getDefaultValue() != null ? opt.getDefaultValue().toString() : null,
+                    opt.getGroup())));
+        }
+
+        return new DataFormatDetailResult(
+                model.getName(),
+                model.getTitle(),
+                model.getDescription(),
+                model.getLabel(),
+                model.isDeprecated(),
+                model.getSupportLevel() != null ? model.getSupportLevel().name() : null,
+                model.getGroupId(),
+                model.getArtifactId(),
+                model.getVersion(),
+                model.getModelName(),
+                options);
+    }
+
+    private LanguageDetailResult toLanguageDetailResult(LanguageModel model) {
+        List<OptionInfo> options = new ArrayList<>();
+        if (model.getOptions() != null) {
+            model.getOptions().forEach(opt -> options.add(new OptionInfo(
+                    opt.getName(),
+                    opt.getDescription(),
+                    opt.getType(),
+                    opt.isRequired(),
+                    opt.getDefaultValue() != null ? opt.getDefaultValue().toString() : null,
+                    opt.getGroup())));
+        }
+
+        return new LanguageDetailResult(
+                model.getName(),
+                model.getTitle(),
+                model.getDescription(),
+                model.getLabel(),
+                model.isDeprecated(),
+                model.getSupportLevel() != null ? model.getSupportLevel().name() : null,
+                model.getGroupId(),
+                model.getArtifactId(),
+                model.getVersion(),
+                model.getModelName(),
+                options);
+    }
+
     // Result record classes for Jackson serialization
 
     public record ComponentListResult(int count, String camelVersion, List<ComponentInfo> components) {
@@ -401,4 +493,14 @@ public class CatalogTools {
     public record EipDetailResult(String name, String title, String description, String label,
             List<OptionInfo> options) {
     }
+
+    public record DataFormatDetailResult(String name, String title, String description, String label,
+            boolean deprecated, String supportLevel, String groupId, String artifactId,
+            String version, String modelName, List<OptionInfo> options) {
+    }
+
+    public record LanguageDetailResult(String name, String title, String description, String label,
+            boolean deprecated, String supportLevel, String groupId, String artifactId,
+            String version, String modelName, List<OptionInfo> options) {
+    }
 }