chore(release): v0.4.0 released

# Conflicts:
#	src/main/java/com/github/codeboyzhou/mcp/declarative/server/McpSyncServerToolRegister.java
#	src/main/java/com/github/codeboyzhou/mcp/declarative/util/ReflectionHelper.java

Author: codeboyzhou

README.md

@@ -14,12 +14,15 @@ Declarative [MCP Java SDK](https://github.com/modelcontextprotocol/java-sdk) Dev
 - No need to write more SDK low-level codes.
 - Get rid of complex and lengthy JSON schema definitions.
 - Just focus on your core logic (resources/prompts/tools).
+- Configuration file compatible with the Spring AI framework.
 
 ## Showcase
 
 Just put this one line code in your `main` method:
 
 ```java
+import com.github.codeboyzhou.mcp.declarative.McpServers;
+
 // You can use this annotation to specify the base package
 // to scan for MCP resources, prompts, tools, but it's optional.
 // If not specified, it will scan the package where the main method is located.
@@ -35,11 +38,34 @@ public class MyMcpServer {
         McpServers.run(MyMcpServer.class, args).startSyncSseServer(
             McpSseServerInfo.builder().name("mcp-server").version("1.0.0").port(8080).build()
         );
+        // or start with yaml configuration file (compatible with the Spring AI framework)
+        McpServers.run(MyMcpServer.class, args).startServer();
+        // or start with a specific configuration file (compatible with the Spring AI framework)
+        McpServers.run(MyMcpServer.class, args).startServer("my-mcp-server.yml");
     }
 
 }
 ```
 
+This is a yaml configuration file example (named `mcp-server.yml` by default, or also `mcp-server.yaml`) only if you are using `startServer()` method:
+
+```yaml
+enabled: true
+stdio: false
+name: mcp-server
+version: 1.0.0
+instructions: mcp-server
+request-timeout: 30000
+type: SYNC
+resource-change-notification: true
+prompt-change-notification: true
+tool-change-notification: true
+sse-message-endpoint: /mcp/message
+sse-endpoint: /sse
+base-url: http://localhost:8080
+sse-port: 8080
+```
+
 No need to care about the low-level details of native MCP Java SDK and how to create the MCP resources, prompts, and tools. Just annotate them like this:
 
 ```java
@@ -103,11 +129,11 @@ Now it's all set, run your MCP server, choose one MCP client you like and start
 Add the following Maven dependency to your project:
 
 ```xml
-<!-- Internally relies on native MCP Java SDK 0.9.0 -->
+<!-- Internally relies on native MCP Java SDK 0.10.0 -->
 <dependency>
     <groupId>io.github.codeboyzhou</groupId>
     <artifactId>mcp-declarative-java-sdk</artifactId>
-    <version>0.3.0</version>
+    <version>0.4.0</version>
 </dependency>
 ```
 

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>io.github.codeboyzhou</groupId>
     <artifactId>mcp-declarative-java-sdk</artifactId>
-    <version>0.3.0</version>
+    <version>0.4.0</version>
 
     <name>MCP Declarative Java SDK</name>
     <description>Annotation-driven MCP (Model Context Protocol) Development with Java - No Spring Framework Required</description>
@@ -51,10 +51,11 @@
         <maven-surefire-plugin.version>3.2.3</maven-surefire-plugin.version>
         <sortpom-maven-plugin.version>4.0.0</sortpom-maven-plugin.version>
         <!--==================== dependency versions ======================-->
+        <jackson-dataformat-yaml.version>2.18.3</jackson-dataformat-yaml.version>
         <jetty.version>12.0.18</jetty.version>
         <junit5.version>5.10.2</junit5.version>
         <logback.version>1.5.18</logback.version>
-        <mcp-sdk.version>0.9.0</mcp-sdk.version>
+        <mcp-sdk.version>0.10.0</mcp-sdk.version>
         <reflections.version>0.10.2</reflections.version>
     </properties>
 
@@ -78,6 +79,11 @@
             <version>${logback.version}</version>
             <scope>test</scope>
         </dependency>
+        <dependency>
+            <groupId>com.fasterxml.jackson.dataformat</groupId>
+            <artifactId>jackson-dataformat-yaml</artifactId>
+            <version>${jackson-dataformat-yaml.version}</version>
+        </dependency>
         <dependency>
             <groupId>io.modelcontextprotocol.sdk</groupId>
             <artifactId>mcp</artifactId>

src/main/java/com/github/codeboyzhou/mcp/declarative/McpServers.java

@@ -2,6 +2,10 @@
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.github.codeboyzhou.mcp.declarative.annotation.McpComponentScan;
+import com.github.codeboyzhou.mcp.declarative.configuration.McpServerConfiguration;
+import com.github.codeboyzhou.mcp.declarative.configuration.YamlConfigurationLoader;
+import com.github.codeboyzhou.mcp.declarative.enums.ServerType;
+import com.github.codeboyzhou.mcp.declarative.exception.McpServerException;
 import com.github.codeboyzhou.mcp.declarative.listener.DefaultMcpSyncHttpServerStatusListener;
 import com.github.codeboyzhou.mcp.declarative.listener.McpHttpServerStatusListener;
 import com.github.codeboyzhou.mcp.declarative.server.McpHttpServer;
@@ -14,18 +18,22 @@
 import io.modelcontextprotocol.server.transport.HttpServletSseServerTransportProvider;
 import io.modelcontextprotocol.server.transport.StdioServerTransportProvider;
 import io.modelcontextprotocol.spec.McpServerTransportProvider;
+import io.modelcontextprotocol.util.Assert;
 import org.reflections.Reflections;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.io.IOException;
+import java.time.Duration;
 
 public class McpServers {
 
+    private static final Logger logger = LoggerFactory.getLogger(McpServers.class);
+
     private static final McpServers INSTANCE = new McpServers();
 
     private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
 
-    private static final String DEFAULT_MESSAGE_ENDPOINT = "/message";
-
-    private static final int DEFAULT_HTTP_SERVER_PORT = 8080;
-
     private static Reflections reflections;
 
     public static McpServers run(Class<?> applicationMainClass, String[] args) {
@@ -46,18 +54,20 @@ private static String determineBasePackage(McpComponentScan scan, Class<?> appli
         return applicationMainClass.getPackageName();
     }
 
+    @Deprecated(since = "0.4.0")
     public void startSyncStdioServer(String name, String version, String instructions) {
+        McpServerInfo serverInfo = McpServerInfo.builder().name(name).version(version)
+            .instructions(instructions).requestTimeout(Duration.ofSeconds(10)).build();
+        startSyncStdioServer(serverInfo);
+    }
+
+    public void startSyncStdioServer(McpServerInfo serverInfo) {
         McpServerFactory<McpSyncServer> factory = new McpSyncServerFactory();
-        McpServerInfo serverInfo = McpServerInfo.builder().name(name).version(version).instructions(instructions).build();
         McpServerTransportProvider transportProvider = new StdioServerTransportProvider();
         McpSyncServer server = factory.create(serverInfo, transportProvider);
         McpServerComponentRegisters.registerAllTo(server, reflections);
     }
 
-    public void startSyncStdioServer(McpServerInfo serverInfo) {
-        startSyncStdioServer(serverInfo.name(), serverInfo.version(), serverInfo.instructions());
-    }
-
     public void startSyncSseServer(McpSseServerInfo serverInfo, McpHttpServerStatusListener<McpSyncServer> listener) {
         McpServerFactory<McpSyncServer> factory = new McpSyncServerFactory();
         HttpServletSseServerTransportProvider transportProvider = new HttpServletSseServerTransportProvider(
@@ -73,4 +83,52 @@ public void startSyncSseServer(McpSseServerInfo serverInfo) {
         startSyncSseServer(serverInfo, new DefaultMcpSyncHttpServerStatusListener());
     }
 
+    public void startServer(String configFileName) {
+        Assert.notNull(configFileName, "configFileName must not be null");
+        YamlConfigurationLoader configurationLoader = new YamlConfigurationLoader();
+        McpServerConfiguration configuration;
+        try {
+            configuration = configurationLoader.load(configFileName);
+            if (configuration.enabled()) {
+                startServerWith(configuration);
+            } else {
+                logger.info("MCP server is disabled.");
+            }
+        } catch (IOException e) {
+            throw new McpServerException("Error loading configuration file: " + e.getMessage(), e);
+        }
+    }
+
+    public void startServer() {
+        YamlConfigurationLoader configurationLoader = new YamlConfigurationLoader();
+        McpServerConfiguration configuration = configurationLoader.loadConfiguration();
+        startServerWith(configuration);
+    }
+
+    private void startServerWith(McpServerConfiguration configuration) {
+        if (ServerType.SYNC.name().equalsIgnoreCase(configuration.type())) {
+            if (configuration.stdio()) {
+                McpServerInfo serverInfo = McpServerInfo.builder()
+                    .name(configuration.name())
+                    .version(configuration.version())
+                    .instructions(configuration.instructions())
+                    .requestTimeout(Duration.ofSeconds(configuration.requestTimeout()))
+                    .build();
+                startSyncStdioServer(serverInfo);
+            } else {
+                McpSseServerInfo serverInfo = McpSseServerInfo.builder()
+                    .name(configuration.name())
+                    .version(configuration.version())
+                    .instructions(configuration.instructions())
+                    .requestTimeout(Duration.ofSeconds(configuration.requestTimeout()))
+                    .baseUrl(configuration.baseUrl())
+                    .messageEndpoint(configuration.sseMessageEndpoint())
+                    .sseEndpoint(configuration.sseEndpoint())
+                    .port(configuration.ssePort())
+                    .build();
+                startSyncSseServer(serverInfo);
+            }
+        }
+    }
+
 }

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

@@ -1,5 +1,7 @@
 package com.github.codeboyzhou.mcp.declarative.annotation;
 
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
+
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
@@ -8,7 +10,7 @@
 @Target(ElementType.TYPE)
 @Retention(RetentionPolicy.RUNTIME)
 public @interface McpComponentScan {
-    String basePackage() default "";
+    String basePackage() default StringHelper.EMPTY;
 
     Class<?> basePackageClass() default Object.class;
 }

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

@@ -0,0 +1,11 @@
+package com.github.codeboyzhou.mcp.declarative.annotation;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface McpJsonSchemaDefinition {
+}

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

@@ -0,0 +1,18 @@
+package com.github.codeboyzhou.mcp.declarative.annotation;
+
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.FIELD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface McpJsonSchemaDefinitionProperty {
+    String name() default StringHelper.EMPTY;
+
+    String description();
+
+    boolean required() default false;
+}

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

@@ -1,5 +1,7 @@
 package com.github.codeboyzhou.mcp.declarative.annotation;
 
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
+
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
@@ -9,7 +11,7 @@
 @Retention(RetentionPolicy.RUNTIME)
 public @interface McpPrompt {
 
-    String name() default "";
+    String name() default StringHelper.EMPTY;
 
     String description();
 }

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

@@ -1,5 +1,6 @@
 package com.github.codeboyzhou.mcp.declarative.annotation;
 
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
 import io.modelcontextprotocol.spec.McpSchema;
 
 import java.lang.annotation.ElementType;
@@ -12,7 +13,7 @@
 public @interface McpResource {
     String uri();
 
-    String name() default "";
+    String name() default StringHelper.EMPTY;
 
     String description();
 

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

@@ -1,5 +1,7 @@
 package com.github.codeboyzhou.mcp.declarative.annotation;
 
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
+
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
@@ -9,7 +11,7 @@
 @Retention(RetentionPolicy.RUNTIME)
 public @interface McpTool {
 
-    String name() default "";
+    String name() default StringHelper.EMPTY;
 
     String description();
 }

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

@@ -0,0 +1,42 @@
+package com.github.codeboyzhou.mcp.declarative.configuration;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import com.github.codeboyzhou.mcp.declarative.util.StringHelper;
+
+public record McpServerConfiguration(
+    @JsonProperty("enabled") boolean enabled,
+    @JsonProperty("stdio") boolean stdio,
+    @JsonProperty("name") String name,
+    @JsonProperty("version") String version,
+    @JsonProperty("instructions") String instructions,
+    @JsonProperty("request-timeout") long requestTimeout,
+    @JsonProperty("type") String type,
+    @JsonProperty("resource-change-notification") boolean resourceChangeNotification,
+    @JsonProperty("prompt-change-notification") boolean promptChangeNotification,
+    @JsonProperty("tool-change-notification") boolean toolChangeNotification,
+    @JsonProperty("sse-message-endpoint") String sseMessageEndpoint,
+    @JsonProperty("sse-endpoint") String sseEndpoint,
+    @JsonProperty("base-url") String baseUrl,
+    @JsonProperty("sse-port") int ssePort
+) {
+
+    public static McpServerConfiguration defaultConfiguration() {
+        return new McpServerConfiguration(
+            true,
+            false,
+            "mcp-server",
+            "1.0.0",
+            "mcp-server",
+            10000,
+            "SYNC",
+            true,
+            true,
+            true,
+            "/mcp/message",
+            "/sse",
+            StringHelper.EMPTY,
+            8080
+        );
+    }
+
+}