feat(server): Add title attribute to MCP prompt, resource and tool specifications

- Add title attribute to McpPrompt, McpPromptParam, McpResource and McpTool annotations
- Implement title handling in corresponding factory classes
- Use "No title specified" as default title when not provided
- Update StringHelper class with new defaultIfBlank method

Author: codeboyzhou

src/main/java/com/github/codeboyzhou/mcp/declarative/annotation/McpPrompt.java

@@ -13,6 +13,8 @@
 
     String name() default StringHelper.EMPTY;
 
+    String title() default StringHelper.EMPTY;
+
     String description() default StringHelper.EMPTY;
 
     String descriptionI18nKey() default StringHelper.EMPTY;

src/main/java/com/github/codeboyzhou/mcp/declarative/annotation/McpPromptParam.java

@@ -13,6 +13,8 @@
 
     String name();
 
+    String title() default StringHelper.EMPTY;
+
     String description() default StringHelper.EMPTY;
 
     String descriptionI18nKey() default StringHelper.EMPTY;

src/main/java/com/github/codeboyzhou/mcp/declarative/annotation/McpResource.java

@@ -15,6 +15,8 @@
 
     String name() default StringHelper.EMPTY;
 
+    String title() default StringHelper.EMPTY;
+
     String description() default StringHelper.EMPTY;
 
     String descriptionI18nKey() default StringHelper.EMPTY;

src/main/java/com/github/codeboyzhou/mcp/declarative/annotation/McpTool.java

@@ -13,6 +13,8 @@
 
     String name() default StringHelper.EMPTY;
 
+    String title() default StringHelper.EMPTY;
+
     String description() default StringHelper.EMPTY;
 
     String descriptionI18nKey() default StringHelper.EMPTY;

src/main/java/com/github/codeboyzhou/mcp/declarative/server/factory/AbstractMcpServerComponentFactory.java

@@ -13,6 +13,8 @@ public abstract class AbstractMcpServerComponentFactory<T> implements McpServerC
 
     private static final String RESOURCE_BUNDLE_BASE_NAME = "i18n/mcp_server_component_descriptions";
 
+    protected static final String NO_TITLE_SPECIFIED = "No title specified";
+
     protected final Injector injector;
 
     private final ResourceBundle bundle;

src/main/java/com/github/codeboyzhou/mcp/declarative/server/factory/McpServerPromptFactory.java

@@ -5,6 +5,7 @@
 import com.github.codeboyzhou.mcp.declarative.annotation.McpPrompts;
 import com.github.codeboyzhou.mcp.declarative.common.BufferQueue;
 import com.github.codeboyzhou.mcp.declarative.util.JsonHelper;
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
 import com.github.codeboyzhou.mcp.declarative.util.TypeConverter;
 import com.google.inject.Inject;
 import com.google.inject.Injector;
@@ -38,9 +39,10 @@ protected McpServerPromptFactory(Injector injector) {
     public McpServerFeatures.AsyncPromptSpecification create(Class<?> clazz, Method method) {
         McpPrompt promptMethod = method.getAnnotation(McpPrompt.class);
         final String name = promptMethod.name().isBlank() ? method.getName() : promptMethod.name();
+        final String title = StringHelper.defaultIfBlank(promptMethod.title(), NO_TITLE_SPECIFIED);
         final String description = getDescription(promptMethod.descriptionI18nKey(), promptMethod.description());
         List<McpSchema.PromptArgument> promptArguments = createPromptArguments(method);
-        McpSchema.Prompt prompt = new McpSchema.Prompt(name, description, promptArguments);
+        McpSchema.Prompt prompt = new McpSchema.Prompt(name, title, description, promptArguments);
         logger.debug("Registering prompt: {}", JsonHelper.toJson(prompt));
         return new McpServerFeatures.AsyncPromptSpecification(prompt, (exchange, request) ->
             Mono.fromSupplier(() -> {
@@ -83,9 +85,10 @@ private List<McpSchema.PromptArgument> createPromptArguments(Method method) {
         for (Parameter param : params) {
             McpPromptParam promptParam = param.getAnnotation(McpPromptParam.class);
             final String name = promptParam.name();
+            final String title = StringHelper.defaultIfBlank(promptParam.title(), NO_TITLE_SPECIFIED);
             final String description = getDescription(promptParam.descriptionI18nKey(), promptParam.description());
             final boolean required = promptParam.required();
-            McpSchema.PromptArgument promptArgument = new McpSchema.PromptArgument(name, description, required);
+            McpSchema.PromptArgument promptArgument = new McpSchema.PromptArgument(name, title, description, required);
             promptArguments.add(promptArgument);
         }
         return promptArguments;

src/main/java/com/github/codeboyzhou/mcp/declarative/server/factory/McpServerResourceFactory.java

@@ -4,6 +4,7 @@
 import com.github.codeboyzhou.mcp.declarative.annotation.McpResources;
 import com.github.codeboyzhou.mcp.declarative.common.BufferQueue;
 import com.github.codeboyzhou.mcp.declarative.util.JsonHelper;
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
 import com.google.inject.Inject;
 import com.google.inject.Injector;
 import io.modelcontextprotocol.server.McpAsyncServer;
@@ -31,9 +32,10 @@ protected McpServerResourceFactory(Injector injector) {
     public McpServerFeatures.AsyncResourceSpecification create(Class<?> clazz, Method method) {
         McpResource res = method.getAnnotation(McpResource.class);
         final String name = res.name().isBlank() ? method.getName() : res.name();
+        final String title = StringHelper.defaultIfBlank(res.title(), NO_TITLE_SPECIFIED);
         final String description = getDescription(res.descriptionI18nKey(), res.description());
         McpSchema.Annotations annotations = new McpSchema.Annotations(List.of(res.roles()), res.priority());
-        McpSchema.Resource resource = new McpSchema.Resource(res.uri(), name, description, res.mimeType(), annotations);
+        McpSchema.Resource resource = new McpSchema.Resource(res.uri(), name, title, description, res.mimeType(), null, annotations);
         logger.debug("Registering resource: {}", JsonHelper.toJson(resource));
         return new McpServerFeatures.AsyncResourceSpecification(resource, (exchange, request) ->
             Mono.fromSupplier(() -> {

src/main/java/com/github/codeboyzhou/mcp/declarative/server/factory/McpServerToolFactory.java

@@ -43,10 +43,11 @@ protected McpServerToolFactory(Injector injector) {
     @Override
     public McpServerFeatures.AsyncToolSpecification create(Class<?> clazz, Method method) {
         McpTool toolMethod = method.getAnnotation(McpTool.class);
-        McpSchema.JsonSchema paramSchema = createJsonSchema(method);
         final String name = toolMethod.name().isBlank() ? method.getName() : toolMethod.name();
+        final String title = StringHelper.defaultIfBlank(toolMethod.title(), NO_TITLE_SPECIFIED);
         final String description = getDescription(toolMethod.descriptionI18nKey(), toolMethod.description());
-        McpSchema.Tool tool = new McpSchema.Tool(name, description, paramSchema);
+        McpSchema.JsonSchema paramSchema = createJsonSchema(method);
+        McpSchema.Tool tool = McpSchema.Tool.builder().name(name).title(title).description(description).inputSchema(paramSchema).build();
         logger.debug("Registering tool: {}", JsonHelper.toJson(tool));
         return new McpServerFeatures.AsyncToolSpecification(tool, (exchange, params) ->
             Mono.fromSupplier(() -> {

src/main/java/com/github/codeboyzhou/mcp/declarative/util/StringHelper.java

@@ -11,4 +11,8 @@ public final class StringHelper {
         throw new UnsupportedOperationException("Utility class should not be instantiated");
     }
 
+    public static String defaultIfBlank(String str, String defaultValue) {
+        return str == null || str.trim().isBlank() ? defaultValue : str;
+    }
+
 }