Improve docs

Author: tzolov

README.md

@@ -1,26 +1,27 @@
-# Java & Spring MCP
+# MCP Java SDK
 [![Build Status](https://github.com/modelcontextprotocol/java-sdk/actions/workflows/continuous-integration.yml/badge.svg)](https://github.com/modelcontextprotocol/java-sdk/actions/workflows/continuous-integration.yml)
 
-Set of projects that provide Java SDK and Spring Framework integration for the [Model Context Protocol](https://modelcontextprotocol.org/docs/concepts/architecture). 
+Set of projects that provide Java SDK 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.
 
 ## 📚 Reference Documentation
-For comprehensive guides and API documentation, visit the [Spring AI MCP Reference Documentation](https://docs.spring.io/spring-ai-mcp/reference/overview.html).
 
-<img src="mcp-docs/src/main/antora/modules/ROOT/images/spring-ai-mcp-clinet-architecture.jpg" width="600">
+For comprehensive guides and API documentation, visit the [MCP Java SDK Reference Documentation](docs/docs/overview.mdx).
 
-<img src="mcp-docs/src/main/antora/modules/ROOT/images/spring-ai-mcp-server-architecture.jpg" width="600">
+<img src="docs/images/java-mcp-client-architecture" width="600">
+
+<img src="docs/images/java-mcp-server-architecture.jpg" width="600">
 
 ## Projects
 
-### [MCP Java SDK](https://docs.spring.io/spring-ai-mcp/reference/mcp.html)
+### MCP 
 
 Java implementation of the Model Context Protocol specification. It includes:
 - Synchronous and asynchronous [MCP Client](https://docs.spring.io/spring-ai-mcp/reference/mcp.html#_mcp_client) and [MCP Server](https://docs.spring.io/spring-ai-mcp/reference/mcp.html#_mcp_server) implementations
 - Standard MCP operations support (tool discovery, resource management, prompt handling, structured logging). Support for request and notification handling.
 - [Stdio](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#stdio) and [SSE](https://spec.modelcontextprotocol.io/specification/2024-11-05/basic/transports/#http-with-sse) transport implementations. 
 
-### MCP Transports
+### MCP Spring
 
 #### Core Transports
 - Stdio-based (`StdioClientTransport`, `StdioServerTransport`) for process-based communication
@@ -32,13 +33,6 @@ Java implementation of the Model Context Protocol specification. It includes:
 - [WebMvc SSE Transport](https://github.com/modelcontextprotocol/java-sdk/tree/main/mcp-spring/mcp-spring-webmvc) - Spring MVC based HTTP SSE transport (Server only). 
 You can use the core `HttpClientSseClientTransport` transport as a SSE client.
 
-### [Spring AI MCP](https://docs.spring.io/spring-ai-mcp/reference/spring-mcp.html)
-
-The Spring integration module provides Spring-specific functionality:
-- Integration with Spring AI's function calling system
-- Spring-friendly abstractions for MCP clients
-- Auto-configurations (WIP)
-
 
 ## Installation
 
@@ -64,24 +58,6 @@ Add the following dependencies to your Maven project:
 </dependency>
 ```
 
-This is a milestone release, not available on Maven Central. 
-Add this repository to your POM:
-
-```xml
-<repositories>
-    <repository>
-        <id>spring-milestones</id>
-        <name>Spring Milestones</name>
-        <url>https://repo.spring.io/milestone</url>
-        <snapshots>
-            <enabled>false</enabled>
-        </snapshots>
-    </repository>
-</repositories>
-```
-
-Reffer to the [Dependency Management](https://docs.spring.io/spring-ai-mcp/reference/dependency-management.html) page for more information.
-
 ## Example Demos
 
 Explore these MCP examples in the [spring-ai-examples/model-context-protocol](https://github.com/spring-projects/spring-ai-examples/tree/main/model-context-protocol) repository:

docs/docs/dependency-management.mdx

@@ -64,41 +64,3 @@ The following dependencies are available and managed by the BOM:
 
 - `org.modelcontextprotocol.sdk:mcp-test` - Testing utilities and support for MCP-based applications.
 
-### Milestone and Snapshot Repositories
-
-To use the Milestone and Snapshot version, you need to add references to the Spring Milestone and/or Snapshot repositories in your build file.
-Add the following repository definitions to your Maven or Gradle build file:
-
-<Tabs>
-  <Tab title="Maven">
-```xml
-<repositories>
-  <repository>
-    <id>spring-milestones</id>
-    <n>Spring Milestones</n>
-    <url>https://repo.spring.io/milestone</url>
-    <snapshots>
-      <enabled>false</enabled>
-    </snapshots>
-  </repository>
-  <repository>
-    <id>spring-snapshots</id>
-    <n>Spring Snapshots</n>
-    <url>https://repo.spring.io/snapshot</url>
-    <releases>
-      <enabled>false</enabled>
-    </releases>
-  </repository>
-</repositories>
-```
-  </Tab>
-
-  <Tab title="Gradle">
-```groovy
-repositories {
-    maven { url 'https://repo.spring.io/milestone' }
-    maven { url 'https://repo.spring.io/snapshot' }
-}
-```
-  </Tab>
-</Tabs>

docs/docs/mcp-overview.mdx

@@ -7,8 +7,8 @@ description: Overview of the Model Context Protocol (MCP) architecture and key c
 
 Java SDK implementation of the [Model Context Protocol](https://modelcontextprotocol.io/introduction), enabling seamless integration with language models and AI tools.
 
-![Spring AI MCP Client Architecture](/images/spring-ai-mcp-client-architecture.jpg)
-![Spring AI MCP Server Architecture](/images/spring-ai-mcp-server-architecture.jpg)
+![Spring AI MCP Client Architecture](/images/java-mcp-client-architecture.jpg)
+![Spring AI MCP Server Architecture](/images/java-mcp-server-architecture.jpg)
 
 ## Features
 
@@ -43,7 +43,7 @@ The SDK follows a layered architecture with clear separation of concerns:
 
 Following class diagram illustrates the layered architecture of the MCP SDK, showing the relationships between core interfaces (McpTransport, McpSession), their implementations, and the client/server components. It highlights how the transport layer connects to sessions, which in turn support both synchronous and asynchronous client/server implementations.
 
-![MCP SDK Class Diagram](/images/spring-ai-mcp-uml-classdiagram.svg)
+![MCP SDK Class Diagram](/images/java-mcp-uml-classdiagram.svg)
 
 Key Interactions:
 

docs/docs/overview.mdx

@@ -3,36 +3,12 @@ title: Overview
 description: Introduction to the Model Context Protocol (MCP) Java SDK
 ---
 
-# Java & Spring MCP
+# MCP Java SDK
 
-Java SDK and Spring Framework integration for the [Model Context Protocol](https://modelcontextprotocol.org/docs/concepts/architecture), enabling standardized interaction with AI models and tools through both synchronous and asynchronous communication.
+Java SDK for the [Model Context Protocol](https://modelcontextprotocol.org/docs/concepts/architecture), enabling standardized interaction with AI models and tools through both synchronous and asynchronous communication.
 
-![Spring AI MCP Client Architecture](/images/spring-ai-mcp-client-architecture.jpg)
-![Spring AI MCP Server Architecture](/images/spring-ai-mcp-server-architecture.jpg)
-
-## Core Components
-
-### [MCP Java SDK](/docs/mcp)
-Core implementation of the Model Context Protocol specification, providing:
-
-- Synchronous and asynchronous [Client](/docs/mcp#mcp-client) and [Server](/docs/mcp#mcp-server) implementations
-- Tool discovery and execution
-- Resource management with URI templates
-- Prompt handling and management
-- Structured logging
-- Request and Notification handling
-
-### MCP Transports
-
-#### Core Transports
-- Stdio-based (`StdioClientTransport`, `StdioServerTransport`) for process-based communication
-- Java HttpClient-based SSE client (`HttpClientSseClientTransport`) for HTTP SSE Client-side streaming
-- Servlet-based SSE server (`HttpServletSseServerTransport`) for HTTP SSE Server streaming using traditional Servlet API
-
-#### Optional SSE Transports
-- [WebFlux SSE Transport](https://github.com/modelcontextprotocol/java-sdk/tree/main/mcp-spring/mcp-spring-webflux) - Reactive HTTP streaming with Spring WebFlux (Client & Server)
-- [WebMvc SSE Transport](https://github.com/modelcontextprotocol/java-sdk/tree/main/mcp-spring/mcp-spring-webmvc) - Spring MVC based SSE transport (Server only). 
-You can use the core `HttpClientSseClientTransport` transport as a SSE client.
+![Java MCP Client Architecture](/images/java-mcp-client-architecture.jpg)
+![Java MCP Server Architecture](/images/java-mcp-server-architecture.jpg)
 
 ## Getting Started
 

docs/images/java-mcp-client-architecture.jpg

@@ -33,7 +33,7 @@
         "docs/mcp-overview",
         "docs/mcp-client",
         "docs/mcp-server",
-        "docs/mcp-spring",
+        "docs/mcp-transport",
         "docs/mcp-capabilities"
       ]
     }