Blueprint Configuration for Prompt, Tool and Resource

Author: tvallin

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/McpHttpFeatureConfigBlueprint.java

@@ -23,8 +23,6 @@
 
 @Prototype.Blueprint
 @Prototype.Configured("mcp")
-//TODO will be removed when using blueprint
-@Prototype.CustomMethods(McpHttpFeatureConfigSupport.McpCustomMethods.class)
 interface McpHttpFeatureConfigBlueprint extends Prototype.Factory<McpHttpFeature> {
 
     @Option.Default("/mcp")

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/McpHttpFeatureConfigSupport.java

@@ -59,62 +59,9 @@ static Builder builder() {
     }
 
     class Builder {
-        List<Tool> tools = new ArrayList<>();
-        List<Prompt> prompts = new ArrayList<>();
-        List<Resource> resources = new ArrayList<>();
-        List<Completion> completions = new ArrayList<>();
-
-        public Builder tool(Consumer<ToolInfo.Builder> info, Function<McpParameters, ToolContent> process) {
-            ToolInfo.Builder builder = ToolInfo.builder();
-            info.accept(builder);
-//            tools.add(Tool.create(builder.build(), process));
-            return this;
-        }
-
-        public Builder prompt(Consumer<PromptInfo.Builder> info, Function<McpParameters, PromptContent> prompt) {
-            PromptInfo.Builder builder = PromptInfo.builder();
-            info.accept(builder);
-//            this.prompts.add(Prompt.create(builder.build(), prompt));
-            return this;
-        }
-
-        public Builder resource(Consumer<ResourceInfo.Builder> info, Supplier<ResourceContent> read) {
-            ResourceInfo.Builder builder = ResourceInfo.builder();
-            info.accept(builder);
-//            this.resources.add(Resource.create(builder.build(), read));
-            return this;
-        }
-
-        public Builder completion(Consumer<CompletionInfo.Builder> info, Function<McpParameters, CompletionContent> complete) {
-            CompletionInfo.Builder builder = CompletionInfo.builder();
-            info.accept(builder);
-//            this.completions.add(Completion.create(builder.build(), complete));
-            return this;
-        }
 
         public McpRouting build() {
-            return new McpRouting() {
-
-                @Override
-                public List<Tool> tools() {
-                    return tools;
-                }
-
-                @Override
-                public List<Prompt> prompts() {
-                    return prompts;
-                }
-
-                @Override
-                public List<Resource> resources() {
-                    return resources;
-                }
-
-                @Override
-                public List<Completion> completions() {
-                    return completions;
-                }
-            };
+            return null;
         }
     }
 }

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/McpRouting.java

@@ -21,10 +21,14 @@
 import java.util.function.Consumer;
 import java.util.function.Function;
 
+import io.helidon.builder.api.Option;
+import io.helidon.builder.api.RuntimeType;
+
 /**
  * MCP Prompt definition.
  */
-public interface Prompt extends Jsonable {
+@RuntimeType.PrototypedBy(PromptConfig.class)
+public interface Prompt extends Jsonable, RuntimeType.Api<PromptConfig> {
     /**
      * Prompt name.
      *
@@ -54,41 +58,20 @@ public interface Prompt extends Jsonable {
      */
     PromptContent prompt(McpParameters parameters);
 
-    static Prompt.Builder builder() {
-        return new Prompt.Builder();
+    @Override
+    default PromptConfig prototype() {
+        return PromptConfig.create();
     }
 
-    class Builder implements io.helidon.common.Builder<Prompt.Builder, Prompt> {
-        private String name;
-        private String description;
-        private Function<McpParameters, PromptContent> prompt;
-        private final Set<PromptArgument> arguments = new HashSet<>();
-
-        public Builder prompt(Function<McpParameters, PromptContent> process) {
-            this.prompt = process;
-            return this;
-        }
-
-        public Builder name(String name) {
-            this.name = name;
-            return this;
-        }
-
-        public Builder description(String description) {
-            this.description = description;
-            return this;
-        }
+    static Prompt create(PromptConfig config) {
+        return config.build();
+    }
 
-        public Builder argument(Consumer<PromptArgument.Builder> builder) {
-            PromptArgument.Builder argumentBuilder = PromptArgument.builder();
-            builder.accept(argumentBuilder);
-            arguments.add(argumentBuilder.build());
-            return this;
-        }
+    static Prompt create(Consumer<PromptConfig.Builder> consumer) {
+        return PromptConfig.builder().update(consumer).build();
+    }
 
-        @Override
-        public Prompt build() {
-            return new PromptImpl(name, description, arguments, prompt);
-        }
+    static PromptConfig.Builder builder() {
+        return PromptConfig.builder();
     }
 }

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/Prompt.java

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2025 Oracle and/or its affiliates.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.helidon.integrations.mcp.server;
+
+import io.helidon.builder.api.Prototype;
+
+/**
+ * Prompt argument information.
+ */
+@Prototype.Blueprint
+interface PromptArgumentBlueprint extends Jsonable {
+    /**
+     * Prompt argument name.
+     *
+     * @return name
+     */
+    String name();
+
+    /**
+     * Prompt argument description.
+     *
+     * @return description
+     */
+    String description();
+
+    /**
+     * Wether this prompt argument is required.
+     *
+     * @return {@code true} if is required, {@code false} otherwise
+     */
+    boolean required();
+
+}

integrations/mcp/server/src/main/java/io/helidon/integrations/mcp/server/PromptArgument.java

@@ -18,10 +18,11 @@
 
 import java.util.Set;
 
+import io.helidon.builder.api.Option;
 import io.helidon.builder.api.Prototype;
 
-//@Prototype.Blueprint
-interface PromptConfigBlueprint {
+@Prototype.Blueprint
+interface PromptConfigBlueprint extends Prototype.Factory<Prompt> {
     /**
      * Prompt name.
      *
@@ -41,6 +42,7 @@ interface PromptConfigBlueprint {
      *
      * @return {@link Set} of argument
      */
+    @Option.Singular
     Set<PromptArgument> arguments();
 
     /**