feat: initialize request utils

micronaut-mcp-server-java-sdk/src/main/java/io/micronaut/mcp/server/utils/InitializeRequestUtils.java

@@ -0,0 +1,61 @@
+/*
+ * Copyright 2017-2025 original authors
+ *
+ * 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
+ *
+ * https://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.micronaut.mcp.server.utils;
+
+import io.micronaut.json.JsonMapper;
+import io.modelcontextprotocol.spec.McpSchema;
+import reactor.util.annotation.NonNull;
+import reactor.util.annotation.Nullable;
+
+import java.io.IOException;
+import java.util.Map;
+import java.util.Optional;
+
+import static io.modelcontextprotocol.spec.McpSchema.METHOD_INITIALIZE;
+
+public final class InitializeRequestUtils {
+    private static final String KEY_METHOD = "method";
+    private static final String KEY_PARAMS = "params";
+
+    private InitializeRequestUtils() {
+    }
+
+    @NonNull
+    public static Optional<McpSchema.InitializeRequest> createInitializeRequest(
+        @NonNull JsonMapper jsonMapper,
+        @Nullable Map<String, Object> body) {
+        if (body == null) {
+            return Optional.empty();
+        }
+        if (!body.containsKey(KEY_METHOD)) {
+            return Optional.empty();
+        }
+        if (!body.get(KEY_METHOD).equals(METHOD_INITIALIZE)) {
+            return Optional.empty();
+        }
+        Object obj = body.get(KEY_PARAMS);
+        if (obj == null) {
+            return Optional.empty();
+        }
+        try {
+            String json = jsonMapper.writeValueAsString(obj);
+            return Optional.of(jsonMapper.readValue(json, McpSchema.InitializeRequest.class));
+        } catch (IOException e) {
+            return Optional.empty();
+        }
+    }
+}
+

micronaut-mcp-server-java-sdk/src/test/java/io/micronaut/mcp/server/utils/InitializeRequestUtilsTest.java

@@ -0,0 +1,44 @@
+package io.micronaut.mcp.server.utils;
+
+import io.micronaut.core.type.Argument;
+import io.micronaut.json.JsonMapper;
+import io.micronaut.test.extensions.junit5.annotation.MicronautTest;
+import io.modelcontextprotocol.spec.McpSchema;
+import org.junit.jupiter.api.Test;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.Map;
+import java.util.Optional;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+@MicronautTest(startApplication = false)
+class InitializeRequestUtilsTest {
+    @Test
+    void initializeRequestUtils(JsonMapper jsonMapper) throws IOException {
+
+        assertFalse(InitializeRequestUtils.createInitializeRequest(jsonMapper, null).isPresent());
+        assertFalse(InitializeRequestUtils.createInitializeRequest(jsonMapper, Collections.emptyMap()).isPresent());
+        assertFalse(InitializeRequestUtils.createInitializeRequest(jsonMapper, jsonMapper.readValue("""
+        {"jsonrpc":"2.0","method":"ping","id":"123"}""", Argument.mapOf(String.class, Object.class))).isPresent());
+        assertFalse(InitializeRequestUtils.createInitializeRequest(jsonMapper, jsonMapper.readValue("""
+            {"jsonrpc":"2.0","id":0,"method":"initialize"}""", Argument.mapOf(String.class, Object.class))).isPresent());
+        String json = """
+            {"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{"sampling":{},"elicitation":{},"roots":{"listChanged":true}},"clientInfo":{"name":"mcp-inspector","version":"0.16.3"}}}""";
+        Map<String, Object> m = jsonMapper.readValue(json, Argument.mapOf(String.class, Object.class));
+        Optional<McpSchema.InitializeRequest> initializeRequestOptional = InitializeRequestUtils.createInitializeRequest(jsonMapper, m);
+        assertTrue(initializeRequestOptional.isPresent());
+        McpSchema.InitializeRequest initializeRequest = initializeRequestOptional.get();
+
+        McpSchema.InitializeRequest expected = new McpSchema.InitializeRequest(
+            "2025-06-18",
+            new McpSchema.ClientCapabilities(null,
+                new McpSchema.ClientCapabilities.RootCapabilities(true),
+                new McpSchema.ClientCapabilities.Sampling(),
+                new McpSchema.ClientCapabilities.Elicitation()),
+            new McpSchema.Implementation("mcp-inspector", "0.16.3"),
+            null);
+            assertEquals(expected, initializeRequest);
+    }
+}