- use real McpSchema.Role enum on McpResource annotation

- simplify mcp description lookup

Author: jknack

modules/jooby-apt/src/main/java/io/jooby/internal/apt/McpRoute.java

@@ -153,28 +153,10 @@ public List<String> generateMcpDefinitionMethod(boolean kt) {
             || type.equals("io.jooby.Context")) continue;
 
         var mcpName = param.getMcpName();
-        var javaName = param.getName();
 
         // 1. Extract the description from the @McpParam annotation
-        var paramDescription = "";
-        var varEl =
-            this.method.getParameters().stream()
-                .filter(p -> p.getSimpleName().toString().equals(javaName))
-                .findFirst()
-                .orElse(null);
-
-        if (varEl != null) {
-          var paramAnno =
-              AnnotationSupport.findAnnotationByName(varEl, "io.jooby.annotation.mcp.McpParam");
-          if (paramAnno != null) {
-            paramDescription =
-                AnnotationSupport.findAnnotationValue(paramAnno, "description"::equals).stream()
-                    .findFirst()
-                    .map(v -> v.replace("\"", ""))
-                    .orElse("");
-          }
-        }
-        if (paramDescription.isEmpty()) {
+        var paramDescription = param.getMcpDescription();
+        if (paramDescription == null) {
           paramDescription = method.map(it -> it.getParameterDoc(param.getName())).orElse("");
         }
 

modules/jooby-apt/src/main/java/io/jooby/internal/apt/MvcParameter.java

@@ -58,6 +58,18 @@ public String getMcpName() {
     return getName();
   }
 
+  public String getMcpDescription() {
+    var annotation = annotations.get("io.jooby.annotation.mcp.McpParam");
+    if (annotation != null) {
+      return io.jooby.internal.apt.AnnotationSupport.findAnnotationValue(
+              annotation, "description"::equals)
+          .stream()
+          .findFirst()
+          .orElse(null);
+    }
+    return null;
+  }
+
   public String generateMapping(boolean kt) {
     var strategy =
         annotations.entrySet().stream()

modules/jooby-apt/src/test/java/tests/i3830/ExampleServer.java

@@ -9,6 +9,7 @@
 import java.util.Map;
 
 import io.jooby.annotation.mcp.*;
+import io.modelcontextprotocol.spec.McpSchema;
 
 @McpServer("example-server")
 public class ExampleServer {
@@ -46,7 +47,7 @@ public String reviewCode(
       size = 1024,
       annotations = {
         @McpResource.McpAnnotations(
-            audience = McpResource.Role.USER,
+            audience = McpSchema.Role.USER,
             lastModified = "1",
             priority = 1.5)
       })

modules/jooby-mcp/src/main/java/io/jooby/annotation/mcp/McpResource.java

@@ -10,6 +10,8 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+import io.modelcontextprotocol.spec.McpSchema;
+
 /**
  * Exposes a method as an MCP Resource or Resource Template.
  *
@@ -57,13 +59,6 @@
   McpAnnotations[]
       annotations() default {}; // Using an array is the safest way to provide an "empty" default in
 
-  // Java annotations
-
-  enum Role {
-    USER,
-    ASSISTANT
-  }
-
   @Retention(RetentionPolicy.RUNTIME)
   @Target(ElementType.ANNOTATION_TYPE)
   @interface McpAnnotations {
@@ -72,7 +67,7 @@ enum Role {
      * Describes who the intended customer of this object or data is. It can include multiple
      * entries to indicate content useful for multiple audiences (e.g., [“user”, “assistant”]).
      */
-    Role[] audience();
+    McpSchema.Role[] audience();
 
     /** The date and time (in ISO 8601 format) when the resource was last modified. */
     String lastModified() default "";