feat(config): Add subscribe-resource capability support in McpServerCapabilities

Author: codeboyzhou

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

@@ -50,6 +50,9 @@ public static void check(McpServerConfiguration configuration) {
     checkNull("request-timeout", configuration.requestTimeout());
     checkNull("capabilities", configuration.capabilities());
     checkNull("resource", configuration.capabilities().resource());
+    if (configuration.capabilities().resource()) {
+      checkNull("subscribe-resource", configuration.capabilities().subscribeResource());
+    }
     checkNull("prompt", configuration.capabilities().prompt());
     checkNull("tool", configuration.capabilities().tool());
     checkNull("completion", configuration.capabilities().completion());

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

@@ -119,6 +119,7 @@ private static McpServerCapabilities mergeCapabilities(
     McpConfigurationChecker.checkNull("capabilities", base, profile);
 
     Boolean resource = null;
+    Boolean subscribeResource = null;
     Boolean prompt = null;
     Boolean tool = null;
     Boolean completion = null;
@@ -127,6 +128,9 @@ private static McpServerCapabilities mergeCapabilities(
       if (base.resource() != null) {
         resource = base.resource();
       }
+      if (resource != null && resource && base.subscribeResource() != null) {
+        subscribeResource = base.subscribeResource();
+      }
       if (base.prompt() != null) {
         prompt = base.prompt();
       }
@@ -142,6 +146,9 @@ private static McpServerCapabilities mergeCapabilities(
       if (profile.resource() != null) {
         resource = profile.resource();
       }
+      if (resource != null && resource && profile.subscribeResource() != null) {
+        subscribeResource = profile.subscribeResource();
+      }
       if (profile.prompt() != null) {
         prompt = profile.prompt();
       }
@@ -158,7 +165,7 @@ private static McpServerCapabilities mergeCapabilities(
     McpConfigurationChecker.checkNull("capabilities.tool", tool);
     McpConfigurationChecker.checkNull("capabilities.completion", completion);
 
-    return new McpServerCapabilities(resource, prompt, tool, completion);
+    return new McpServerCapabilities(resource, subscribeResource, prompt, tool, completion);
   }
 
   /**

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

@@ -9,6 +9,7 @@
  */
 public record McpServerCapabilities(
     @JsonProperty("resource") Boolean resource,
+    @JsonProperty("subscribe-resource") Boolean subscribeResource,
     @JsonProperty("prompt") Boolean prompt,
     @JsonProperty("tool") Boolean tool,
     @JsonProperty("completion") Boolean completion) {
@@ -20,7 +21,7 @@ public record McpServerCapabilities(
    */
   @Deprecated
   public McpServerCapabilities() {
-    this(true, true, true, true);
+    this(true, true, true, true, true);
   }
 
   /**
@@ -37,6 +38,9 @@ public static class Builder {
     /** The resource capability. */
     private Boolean resource;
 
+    /** The subscribe-resource capability. */
+    private Boolean subscribeResource;
+
     /** The prompt capability. */
     private Boolean prompt;
 
@@ -57,6 +61,17 @@ public Builder resource(Boolean resource) {
       return this;
     }
 
+    /**
+     * Sets the subscribe-resource capability.
+     *
+     * @param subscribeResource The subscribe-resource capability.
+     * @return This builder instance.
+     */
+    public Builder subscribeResource(Boolean subscribeResource) {
+      this.subscribeResource = subscribeResource;
+      return this;
+    }
+
     /**
      * Sets the prompt capability.
      *
@@ -96,7 +111,7 @@ public Builder completion(Boolean completion) {
      * @return A new instance of {@code McpServerCapabilities}.
      */
     public McpServerCapabilities build() {
-      return new McpServerCapabilities(resource, prompt, tool, completion);
+      return new McpServerCapabilities(resource, subscribeResource, prompt, tool, completion);
     }
   }
 }

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

@@ -40,7 +40,9 @@ private McpSchema.ServerCapabilities serverCapabilities(S serverInfo) {
     McpServerCapabilities capabilitiesConfig = serverInfo.capabilities();
     McpServerChangeNotification serverChangeNotification = serverInfo.changeNotification();
     if (capabilitiesConfig.resource()) {
-      capabilities.resources(true, serverChangeNotification.resource());
+      final Boolean subscribe = capabilitiesConfig.subscribeResource();
+      final Boolean changeNotification = serverChangeNotification.resource();
+      capabilities.resources(subscribe, changeNotification);
     }
     if (capabilitiesConfig.prompt()) {
       capabilities.prompts(serverChangeNotification.prompt());

src/main/java/com/github/codeboyzhou/mcp/declarative/server/configurable/AbstractConfigurableMcpServer.java

@@ -58,7 +58,9 @@ private McpSchema.ServerCapabilities serverCapabilities() {
     McpServerCapabilities capabilitiesConfig = configuration.capabilities();
     McpServerChangeNotification serverChangeNotification = configuration.changeNotification();
     if (capabilitiesConfig.resource()) {
-      capabilities.resources(true, serverChangeNotification.resource());
+      final Boolean subscribe = capabilitiesConfig.subscribeResource();
+      final Boolean changeNotification = serverChangeNotification.resource();
+      capabilities.resources(subscribe, changeNotification);
     }
     if (capabilitiesConfig.prompt()) {
       capabilities.prompts(serverChangeNotification.prompt());

src/test/resources/mcp-server.yml

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

src/test/resources/test-mcp-server-disabled.yml

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

src/test/resources/test-mcp-server-enable-http-sse-mode.yml

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

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

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

src/test/resources/test-mcp-server-enable-streamable-http-mode.yml

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