feat(config): Add getDefault() methods for configuration record classes and update default values

Author: codeboyzhou

src/main/java/com/github/codeboyzhou/mcp/declarative/configuration/McpServerCapabilities.java

@@ -15,22 +15,29 @@ public record McpServerCapabilities(
     @JsonProperty("completion") Boolean completion) {
 
   /**
-   * Creates a new instance of {@code McpServerCapabilities} with default values.
+   * Creates a new instance of {@code Builder} to build {@code McpServerCapabilities}.
    *
-   * <p>By default, all capabilities are set to {@code true}.
+   * @return A new instance of {@code Builder}.
    */
-  @Deprecated
-  public McpServerCapabilities() {
-    this(true, true, true, true, true);
+  public static Builder builder() {
+    return new Builder();
   }
 
   /**
-   * Creates a new instance of {@code Builder} to build {@code McpServerCapabilities}.
+   * Returns the default capabilities of the MCP server.
    *
-   * @return A new instance of {@code Builder}.
+   * <p>By default, all capabilities are set to {@code true}.
+   *
+   * @return The default capabilities of the MCP server.
    */
-  public static Builder builder() {
-    return new Builder();
+  public static McpServerCapabilities getDefault() {
+    return builder()
+        .resource(true)
+        .subscribeResource(true)
+        .prompt(true)
+        .tool(true)
+        .completion(true)
+        .build();
   }
 
   /** Builder class for {@code McpServerCapabilities}. */

src/main/java/com/github/codeboyzhou/mcp/declarative/configuration/McpServerChangeNotification.java

@@ -17,22 +17,23 @@ public record McpServerChangeNotification(
     @JsonProperty("tool") Boolean tool) {
 
   /**
-   * Creates a new instance of {@code McpServerChangeNotification} with default values.
+   * Creates a new instance of {@code Builder} to build {@code McpServerChangeNotification}.
    *
-   * <p>By default, all change notification flags are set to {@code true}.
+   * @return A new instance of {@code Builder}.
    */
-  @Deprecated
-  public McpServerChangeNotification() {
-    this(true, true, true);
+  public static Builder builder() {
+    return new Builder();
   }
 
   /**
-   * Creates a new instance of {@code Builder} to build {@code McpServerChangeNotification}.
+   * Returns the default change notification of the MCP server.
    *
-   * @return A new instance of {@code Builder}.
+   * <p>By default, all change notification flags are set to {@code true}.
+   *
+   * @return The default change notification of the MCP server.
    */
-  public static Builder builder() {
-    return new Builder();
+  public static McpServerChangeNotification getDefault() {
+    return builder().resource(true).prompt(true).tool(true).build();
   }
 
   /** Builder class for {@code McpServerChangeNotification}. */

src/main/java/com/github/codeboyzhou/mcp/declarative/configuration/McpServerConfiguration.java

@@ -3,6 +3,7 @@
 import com.fasterxml.jackson.annotation.JsonProperty;
 import com.github.codeboyzhou.mcp.declarative.enums.ServerMode;
 import com.github.codeboyzhou.mcp.declarative.enums.ServerType;
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
 
 /**
  * This record represents the configuration of an MCP (Model Context Protocol) server.
@@ -38,6 +39,35 @@ public static Builder builder() {
     return new Builder();
   }
 
+  /**
+   * Returns the default configuration of the MCP server.
+   *
+   * <p>By default, the enabled status is {@code true}, the server mode is {@link
+   * ServerMode#STREAMABLE}, the server name is "mcp-server", the server version is "1.0.0", the
+   * server type is {@link ServerType#SYNC}, the server instructions is {@link StringHelper#EMPTY},
+   * the request timeout is 20000 milliseconds, the capabilities is {@link
+   * McpServerCapabilities#getDefault()}, the change notification is {@link
+   * McpServerChangeNotification#getDefault()}, the SSE is {@link McpServerSSE#getDefault()}, and
+   * the streamable is {@link McpServerStreamable#getDefault()}.
+   *
+   * @return The default configuration of the MCP server.
+   */
+  public static McpServerConfiguration getDefault() {
+    return builder()
+        .enabled(true)
+        .mode(ServerMode.STREAMABLE)
+        .name("mcp-server")
+        .version("1.0.0")
+        .type(ServerType.SYNC)
+        .instructions(StringHelper.EMPTY)
+        .requestTimeout(20000L)
+        .capabilities(McpServerCapabilities.getDefault())
+        .changeNotification(McpServerChangeNotification.getDefault())
+        .sse(McpServerSSE.getDefault())
+        .streamable(McpServerStreamable.getDefault())
+        .build();
+  }
+
   /** Builder class for {@code McpServerConfiguration}. */
   public static class Builder {
     /** The profile. */

src/main/java/com/github/codeboyzhou/mcp/declarative/configuration/McpServerSSE.java

@@ -1,6 +1,7 @@
 package com.github.codeboyzhou.mcp.declarative.configuration;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
 
 /**
  * This record represents the Server-Sent Events (SSE) configuration for an MCP (Model Context
@@ -27,6 +28,23 @@ public static Builder builder() {
     return new Builder();
   }
 
+  /**
+   * Returns the default SSE configuration of the MCP server.
+   *
+   * <p>By default, the message endpoint is "/mcp/message", the endpoint is "/sse", the base URL is
+   * {@link StringHelper#EMPTY}, and the port is 8080.
+   *
+   * @return The default SSE configuration of the MCP server.
+   */
+  public static McpServerSSE getDefault() {
+    return builder()
+        .messageEndpoint("/mcp/message")
+        .endpoint("/sse")
+        .baseUrl(StringHelper.EMPTY)
+        .port(8080)
+        .build();
+  }
+
   /** Builder class for {@code McpServerSSE}. */
   public static class Builder {
     /** The message endpoint. */

src/main/java/com/github/codeboyzhou/mcp/declarative/configuration/McpServerStreamable.java

@@ -28,6 +28,23 @@ public static Builder builder() {
     return new Builder();
   }
 
+  /**
+   * Returns the default streamable http server configuration of the MCP server.
+   *
+   * <p>By default, the MCP endpoint is "/mcp/streamable", the disallow delete flag is {@code
+   * false}, the keep-alive interval is 10000 milliseconds, and the port is 8080.
+   *
+   * @return The default streamable http server configuration of the MCP server.
+   */
+  public static McpServerStreamable getDefault() {
+    return builder()
+        .mcpEndpoint("/mcp")
+        .disallowDelete(false)
+        .keepAliveInterval(0L)
+        .port(8080)
+        .build();
+  }
+
   /** Builder class for {@code McpServerStreamable}. */
   public static class Builder {
     /** The MCP endpoint. */

src/main/java/com/github/codeboyzhou/mcp/declarative/server/McpServerInfo.java

@@ -121,20 +121,24 @@ public static class Builder<T extends Builder<T>> {
     /** The version of the MCP server. Default value is {@code "1.0.0"}. */
     protected String version = "1.0.0";
 
-    /** The instructions of the MCP server. Default value is {@code ""}. */
+    /** The instructions of the MCP server. Default value is {@link StringHelper#EMPTY}. */
     protected String instructions = StringHelper.EMPTY;
 
     /** The request timeout of the MCP server. Default value is {@code 20} seconds. */
     protected Duration requestTimeout = Duration.ofSeconds(20);
 
-    /** The capabilities of the MCP server. Default value is {@code new McpServerCapabilities()}. */
-    protected McpServerCapabilities capabilities = new McpServerCapabilities();
+    /**
+     * The capabilities of the MCP server. Default value is {@link
+     * McpServerCapabilities#getDefault()}.
+     */
+    protected McpServerCapabilities capabilities = McpServerCapabilities.getDefault();
 
     /**
-     * The change notification of the MCP server. Default value is {@code new
-     * McpServerChangeNotification()}.
+     * The change notification of the MCP server. Default value is {@link
+     * McpServerChangeNotification#getDefault()}.
      */
-    protected McpServerChangeNotification changeNotification = new McpServerChangeNotification();
+    protected McpServerChangeNotification changeNotification =
+        McpServerChangeNotification.getDefault();
 
     /**
      * Returns the self reference of the builder, which is used to chain the method calls and ensure

src/main/resources/mcp-server.yml

@@ -4,9 +4,10 @@ name: mcp-server
 version: 1.0.0
 type: SYNC
 instructions: You are a helpful AI assistant
-request-timeout: 20000
+request-timeout: 60000
 capabilities:
   resource: true
+  subscribe-resource: true
   prompt: true
   tool: true
   completion: true
@@ -18,4 +19,4 @@ streamable:
   mcp-endpoint: /mcp/message
   disallow-delete: true
   keep-alive-interval: 30000
-  port: 8080
+  port: 9000

src/test/java/com/github/codeboyzhou/mcp/declarative/McpServersTest.java

@@ -111,6 +111,15 @@ void testStartStreamableServer_shouldSucceed() {
     }
   }
 
+  @Test
+  void testStartServer_useDefaultConfigFileName_shouldSucceed() {
+    String configFileName = "mcp-server.yml";
+    McpConfigurationLoader configLoader = new McpConfigurationLoader(configFileName);
+    McpServerConfiguration configuration = configLoader.loadConfig();
+    assertEquals(ServerMode.STREAMABLE, configuration.mode());
+    assertDoesNotThrow(() -> servers.startServer());
+  }
+
   @Test
   void testStartServer_disabledMCP_shouldSucceed() {
     String configFileName = "test-mcp-server-disabled.yml";
@@ -153,15 +162,6 @@ void testStartServer_enableUnknownMode_shouldThrowException() {
     assertThrows(McpServerConfigurationException.class, () -> servers.startServer(configFileName));
   }
 
-  @Test
-  void testStartServer_useDefaultConfigFileName_shouldSucceed() {
-    String configFileName = "mcp-server.yml";
-    McpConfigurationLoader configLoader = new McpConfigurationLoader(configFileName);
-    McpServerConfiguration configuration = configLoader.loadConfig();
-    assertEquals(ServerMode.STREAMABLE, configuration.mode());
-    assertDoesNotThrow(() -> servers.startServer());
-  }
-
   private void verify(McpSyncClient client) {
     verifyServerInfo(client);
     verifyResourcesRegistered(client);

src/test/resources/test-mcp-server-enable-unknown-mode.yml

@@ -7,8 +7,10 @@ instructions: You are a helpful AI assistant
 request-timeout: 60000
 capabilities:
   resource: true
+  subscribe-resource: true
   prompt: true
   tool: true
+  completion: true
 change-notification:
   resource: true
   prompt: true

src/test/resources/test-mcp-server-with-profile-dev.yml

@@ -4,6 +4,7 @@ instructions: You are a helpful AI assistant (dev profile)
 request-timeout: 60000
 capabilities:
   resource: false
+  subscribe-resource: false
 change-notification:
   resource: false
 streamable: