refactor: rename artifacts and restructure modules

- Rename spring-ai-mcp-core to mcp for simpler artifact naming
- Rename spring-ai-mcp-spring to spring-ai-mcp for clarity
- Rename parent artifact from spring-ai-mcp to mcp-parent
- Update artifact references in pom files and documentation
- Update directory structure and paths in GitHub workflow

Resolves #31

chore: improve module descriptions and update dependencies

- Update parent pom description to better reflect overall project scope
- Update mcp module description to detail core Java SDK capabilities
- Update spring-ai-mcp module description to emphasize Spring integration features
- Update dependency versions to stable releases:
  * JUnit: 5.11.3 -> 5.10.2
  * Jackson: 2.18.2 -> 2.17.0

Author: tzolov

.github/workflows/maven-central-release.yml

@@ -17,9 +17,9 @@ jobs:
 
       - name: Prepare directory structure
         run: |
+          mkdir -p nexus/org/springframework/experimental/mcp-parent/$RELEASE_VERSION
+          mkdir -p nexus/org/springframework/experimental/mcp/$RELEASE_VERSION
           mkdir -p nexus/org/springframework/experimental/spring-ai-mcp/$RELEASE_VERSION
-          mkdir -p nexus/org/springframework/experimental/spring-ai-mcp-core/$RELEASE_VERSION
-          mkdir -p nexus/org/springframework/experimental/spring-ai-mcp-spring/$RELEASE_VERSION
 
       - name: Download release files from Artifactory
         env:
@@ -33,19 +33,19 @@ jobs:
           
           echo "Downloading core artifacts"
           cd ../../../../../..
-          cd nexus/org/springframework/experimental/spring-ai-mcp-core/$RELEASE_VERSION
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-core/$RELEASE_VERSION/spring-ai-mcp-core-$RELEASE_VERSION.pom
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-core/$RELEASE_VERSION/spring-ai-mcp-core-$RELEASE_VERSION.jar
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-core/$RELEASE_VERSION/spring-ai-mcp-core-$RELEASE_VERSION-javadoc.jar
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-core/$RELEASE_VERSION/spring-ai-mcp-core-$RELEASE_VERSION-sources.jar
+          cd nexus/org/springframework/experimental/mcp/$RELEASE_VERSION
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/mcp/$RELEASE_VERSION/mcp-$RELEASE_VERSION.pom
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/mcp/$RELEASE_VERSION/mcp-$RELEASE_VERSION.jar
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/mcp/$RELEASE_VERSION/mcp-$RELEASE_VERSION-javadoc.jar
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/mcp/$RELEASE_VERSION/mcp-$RELEASE_VERSION-sources.jar
 
           echo "Downloading spring artifacts"
           cd ../../../../../..
-          cd nexus/org/springframework/experimental/spring-ai-mcp-spring/$RELEASE_VERSION
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-spring/$RELEASE_VERSION/spring-ai-mcp-spring-$RELEASE_VERSION.pom
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-spring/$RELEASE_VERSION/spring-ai-mcp-spring-$RELEASE_VERSION.jar
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-spring/$RELEASE_VERSION/spring-ai-mcp-spring-$RELEASE_VERSION-javadoc.jar
-          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp-spring/$RELEASE_VERSION/spring-ai-mcp-spring-$RELEASE_VERSION-sources.jar
+          cd nexus/org/springframework/experimental/spring-ai-mcp/$RELEASE_VERSION
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp/$RELEASE_VERSION/spring-ai-mcp-$RELEASE_VERSION.pom
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp/$RELEASE_VERSION/spring-ai-mcp-$RELEASE_VERSION.jar
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp/$RELEASE_VERSION/spring-ai-mcp-$RELEASE_VERSION-javadoc.jar
+          wget --user="$ARTIFACTORY_USERNAME" --password="$ARTIFACTORY_PASSWORD" $ARTIFACTORY_URL/spring-ai-mcp/$RELEASE_VERSION/spring-ai-mcp-$RELEASE_VERSION-sources.jar
 
       - name: Sign artifacts and release them to Maven Central
         uses: spring-io/nexus-sync-action@main

README.md

@@ -1,26 +1,26 @@
-# Spring AI MCP
+# Java & Spring MCP
 
 Java SDK for the Model Context Protocol (MCP), providing seamless integration between Java and Spring applications and MCP-compliant AI resources and tools.
 
 ## Overview
 
-Spring AI MCP is an experimental project that provides Java and Spring Framework integration for the [Model Context Protocol](https://modelcontextprotocol.org/docs/concepts/architecture). It enables Java applications to interact with AI models and tools through a standardized interface, supporting both synchronous and asynchronous communication patterns.
+Experimental project that provides Java and Spring Framework integration for the [Model Context Protocol](https://modelcontextprotocol.org/docs/concepts/architecture). It enables Java applications to interact with AI models and tools through a standardized interface, supporting both synchronous and asynchronous communication patterns.
 
 <img src="docs/spring-ai-mcp-architecture.jpg" width="600">
 
 ## Modules
 
 The project consists of two main modules:
 
-### [mcp-core](./spring-ai-mcp-core/README.md)
+### [mcp](./mcp/README.md)
 
 The core module provides a Java implementation of the Model Context Protocol specification. It includes:
 - Synchronous and asynchronous client implementations
 - Standard MCP operations support (tool discovery, resource management, prompt handling). Support for request and notificaiotn handling.
 - [Stdio](https://spec.modelcontextprotocol.io/specification/basic/transports/#stdio) and [SSE](https://spec.modelcontextprotocol.io/specification/basic/transports/#http-with-sse) transport implementations. 
-- [Find more](./spring-ai-mcp-core/README.md).
+- [Find more](./mcp/README.md).
 
-### [mcp-spring](./spring-ai-mcp-spring/README.md)
+### [spring-ai-mcp](./spring-ai-mcp/README.md)
 
 The Spring integration module provides Spring-specific functionality:
 - Integration with Spring AI's function calling system
@@ -41,14 +41,14 @@ Add the following dependencies to your Maven project:
 <!-- For core MCP functionality -->
 <dependency>
     <groupId>org.springframework.experimental</groupId>
-    <artifactId>spring-ai-mcp-core</artifactId>
+    <artifactId>mcp</artifactId>
     <version>0.2.0-SNAPSHOT</version>
 </dependency>
 
-<!-- For Spring integration -->
+<!-- For Spring AI integration -->
 <dependency>
     <groupId>org.springframework.experimental</groupId>
-    <artifactId>spring-ai-mcp-spring</artifactId>
+    <artifactId>spring-ai-mcp</artifactId>
     <version>0.2.0-SNAPSHOT</version>
 </dependency>
 ```
@@ -64,9 +64,9 @@ Explore these MCP examples in the [spring-ai-examples/model-context-protocol](ht
 
 ## Documentation
 
-- [Core Module Documentation](spring-ai-mcp-core/README.md)
-- [Spring Integration Documentation](spring-ai-mcp-spring/README.md)
-- [UML Class Diagrams](spring-ai-mcp-core/docs/spring-ai-mcp-uml-classdiagram.svg)
+- [Core Module Documentation](mcp/README.md)
+- [Spring Integration Documentation](spring-ai-mcp/README.md)
+- [UML Class Diagrams](spring-ai-mcp/docs/spring-ai-mcp-uml-classdiagram.svg)
 
 ## Development
 

spring-ai-mcp-core/README.md renamed to mcp/README.md

@@ -8,7 +8,8 @@ This SDK implements the Model Context Protocol, enabling seamless integration wi
 
 ## Features
 
-- Synchronous and Asynchronous client implementations
+- Synchronous and Asynchronous MCP Client implementations
+- Synchronous and Asynchronous MCP Server implementations (WIP: comming with 0.3.0)
 - Standard MCP operations support:
   - Protocol version compatibility negotiation
   - Client-server capability exchange
@@ -32,7 +33,7 @@ Add the following dependency to your Maven project:
 ```xml
 <dependency>
     <groupId>org.springframework.experimental</groupId>
-    <artifactId>spring-ai-mcp-core</artifactId>
+    <artifactId>mcp</artifactId>
     <version>0.2.0-SNAPSHOT</version>
 </dependency>
 ```
@@ -60,10 +61,6 @@ Server-Sent Events (SSE) based transport following the MCP HTTP with SSE transpo
 WebClient.Builder webClientBuilder = WebClient.builder()
     .baseUrl("http://your-mcp-server");
 McpTransport transport = new SseClientTransport(webClientBuilder);
-
-// Or with custom ObjectMapper
-ObjectMapper mapper = new ObjectMapper();
-McpTransport transport = new SseClientTransport(webClientBuilder, mapper);
 ```
 
 The SSE transport provides:
@@ -74,52 +71,14 @@ The SSE transport provides:
 - Graceful shutdown handling
 - Configurable JSON serialization
 
-### Roots List Support
-
-The SDK supports the MCP roots list capability, which allows servers to understand which directories and files they have access to. Clients can provide a list of root directories/files and notify servers when this list changes.
-
-#### Features
-- Define root providers that supply filesystem access boundaries
-- Support for roots list changed notifications
-- Automatic roots list request handling
-
-#### Example with Roots List Configuration
-
-```java
-// Create root providers
-List<Supplier<List<Root>>> rootProviders = List.of(
-    () -> List.of(new Root("file:///workspace/project", "Project Root")),
-    () -> List.of(new Root("file:///workspace/docs", "Documentation"))
-);
-
-// Create async client with roots list support
-McpAsyncClient client = new McpAsyncClient(
-    new StdioClientTransport(params),
-    Duration.ofSeconds(30),
-    rootProviders,  // Configure root providers
-    true           // Enable roots list changed notifications
-);
-
-// Initialize connection
-client.initialize()
-    .doOnSuccess(result -> {
-        // Connection initialized with roots list capability
-        
-        // Notify server when roots list changes
-        return client.sendRootsListChanged();
-    })
-    .subscribe();
-```
 
-### Sync Client Example
+### Sync MCP Client Example
 
 ```java
 // Create and initialize sync client
-ServerParameters params = ServerParameters.builder("npx")
-    .args("-y", "@modelcontextprotocol/server-everything", "dir")
-    .build();
+McpTransport mcpTransport = ...
 
-try (McpSyncClient client = McpClient.sync(new StdioClientTransport(params))) {
+try (McpSyncClient client = McpClient.using(mcpTransport).sync()) {
     // Initialize connection with protocol version and capabilities
     McpSchema.InitializeResult initResult = client.initialize();
 
@@ -145,20 +104,15 @@ try (McpSyncClient client = McpClient.sync(new StdioClientTransport(params))) {
 }
 ```
 
-### Async Client Example with Custom Configuration
+### Async MCP Client Example with Custom Configuration
 
 ```java
-// Create server parameters
-ServerParameters params = ServerParameters.builder("npx")
-    .args("-y", "@modelcontextprotocol/server-everything", "dir")
-    .build();
+McpTransport mcpTransport = ...
 
 // Initialize async client with custom timeout and object mapper
-McpAsyncClient client = McpClient.async(
-    new StdioClientTransport(params),
-    Duration.ofSeconds(30),
-    new ObjectMapper()
-);
+McpAsyncClient client = McpClient.using(mcpTransport)
+    .requestTimeout(Duration.ofSeconds(30))
+    .async();
 
 // Initialize connection and chain operations
 var result = client.initialize()
@@ -261,7 +215,44 @@ The SDK follows a layered architecture with clear separation of concerns:
    - Execution handling with timeout support
    - Result processing with error handling
 
-### Change Notifications
+### Roots List Support
+
+The SDK supports the MCP roots list capability, which allows servers to understand which directories and files they have access to. Clients can provide a list of root directories/files and notify servers when this list changes.
+
+#### Features
+- Define root providers that supply filesystem access boundaries
+- Support for roots list changed notifications
+- Automatic roots list request handling
+
+#### Example with Roots List Configuration
+
+```java
+// Create root providers
+List<Supplier<List<Root>>> rootProviders = List.of(
+    () -> List.of(new Root("file:///workspace/project", "Project Root")),
+    () -> List.of(new Root("file:///workspace/docs", "Documentation"))
+);
+
+// Create async client with roots list support
+McpAsyncClient client = new McpAsyncClient(
+    new StdioClientTransport(params),
+    Duration.ofSeconds(30),
+    rootProviders,  // Configure root providers
+    true           // Enable roots list changed notifications
+);
+
+// Initialize connection
+client.initialize()
+    .doOnSuccess(result -> {
+        // Connection initialized with roots list capability
+        
+        // Notify server when roots list changes
+        return client.sendRootsListChanged();
+    })
+    .subscribe();
+```
+
+### Change Notifications Support
 
 The SDK supports automatic handling of changes through a non-blocking notification system for tools, resources, and prompts:
 

spring-ai-mcp-core/pom.xml renamed to mcp/pom.xml

@@ -5,13 +5,13 @@
 	<modelVersion>4.0.0</modelVersion>
 	<parent>
 		<groupId>org.springframework.experimental</groupId>
-		<artifactId>spring-ai-mcp</artifactId>
+		<artifactId>mcp-parent</artifactId>
 		<version>0.2.0-SNAPSHOT</version>
 	</parent>
-	<artifactId>spring-ai-mcp-core</artifactId>
+	<artifactId>mcp</artifactId>
 	<packaging>jar</packaging>
-	<name>Spring AI MCP Core</name>
-	<description>Demo project for Spring Boot</description>
+	<name>Java MCP SDK</name>
+	<description>Core Java implementation of the Model Context Protocol (MCP) specification, providing synchronous and asynchronous clients, server implementations (coming in 0.3.0), with support for tool discovery, resource management, and multiple transport implementations</description>
 	<url>https://github.com/spring-projects-experimental/spring-ai-mcp</url>
 
 	<scm>

spring-ai-mcp-core/src/main/java/org/springframework/ai/mcp/client/McpAsyncClient.java renamed to mcp/src/main/java/org/springframework/ai/mcp/client/McpAsyncClient.java

@@ -40,10 +40,6 @@
  * </ul>
  *
  * <p>
- * Each client type can be instantiated with default settings or with custom configuration
- * including request timeout and JSON object mapping.
- *
- * <p>
  * Use the builder pattern for flexible client configuration:
  *
  * <pre>{@code