Skip to content

Commit b0b8010

Browse files
committed
Update the docs for Spring AI 2.1 modern support
- Spring AI 2.1+ integrates the modern client and server; both modern guides gain a "Spring" section and drop it from "Not Yet Supported". - Legacy server guide: spec links point to the 2025-11-25 revision. - Documentation development page: project structure matches the folder. Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>
1 parent 38519ce commit b0b8010

7 files changed

Lines changed: 28 additions & 12 deletions

File tree

‎docs/client-modern.md‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,12 @@ is closed, every open call fails with `McpResponseLostException`.
194194
`StdioMcpClientTransport.builder(InputStream, OutputStream)` runs over streams that are already connected,
195195
such as a socket's.
196196

197+
### Spring
198+
199+
Spring Boot integration for the modern client is part of Spring AI 2.1+, not of this SDK. Its MCP Client Boot
200+
Starter configures modern connections and exposes their tools to Spring AI as tool callbacks. See
201+
[MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) in the Spring AI reference.
202+
197203
### Custom Transports
198204

199205
Other transports implement `McpClientTransport`. Its single method, `exchange(McpTransportRequest)`, sends one
@@ -739,7 +745,6 @@ Failures outside those two types:
739745
- Servers of earlier revisions. Use the [legacy client](client.md) for those.
740746
- Obtaining OAuth tokens. Add tokens with a request customizer, as shown in
741747
[Identity and Authorization](#identity-and-authorization).
742-
- Spring WebClient transport.
743748

744749
For a larger working example, see the
745750
[modern conformance client](https://github.com/modelcontextprotocol/java-sdk/tree/main/conformance-tests/client-modern),

‎docs/development.md‎

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -51,14 +51,17 @@ The built site will be output to the `site/` directory.
5151

5252
```
5353
docs/
54-
├── index.md # Overview page
54+
├── index.md # Home page
55+
├── overview.md # Architecture and modules
5556
├── quickstart.md # Quickstart guide
56-
├── client.md # MCP Client documentation
57-
├── server.md # MCP Server documentation
58-
├── contributing.md # Contributing guide
57+
├── client-modern.md # MCP Client, modern (2026-07-28)
58+
├── server-modern.md # MCP Server, modern (2026-07-28)
59+
├── client.md # MCP Client, legacy (2025-11-25 and earlier)
60+
├── server.md # MCP Server, legacy (2025-11-25 and earlier)
61+
├── contribute.md # Contributing guide
5962
├── development.md # This page
60-
├── images/ # Images and diagrams
61-
└── stylesheets/ # Custom CSS
63+
├── blog/ # Blog posts
64+
└── images/ # Images and diagrams
6265
mkdocs.yml # MkDocs configuration
6366
```
6467

‎docs/index.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,7 @@ Both implementations share the following:
4646
!!! tip "Spring applications"
4747
Spring WebFlux and WebMVC transports for the legacy client and server are part of [Spring AI](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ and are not shipped by this SDK.
4848
Use the [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and the [MCP Server Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-server-boot-starter-docs.html) from Spring AI.
49+
For the modern client and server, Spring AI 2.1+ provides Boot starters and Spring transports; see [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html).
4950
Also consider the [MCP Annotations](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-annotations-overview.html) and [MCP Security](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-security.html).
5051

5152
## Getting Started

‎docs/overview.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,7 @@ The SDK is organized into modules to separate concerns and allow adopters to bri
116116
A minimal adopter may depend only on `mcp` (core + Jackson 3).
117117

118118
Spring-based applications that use the legacy client or server should use the `mcp-spring-webflux` or `mcp-spring-webmvc` artifacts from [Spring AI](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-overview.html) 2.0+ (group `org.springframework.ai`), which are no longer part of this SDK.
119+
For the modern client and server, Spring AI 2.1+ provides Boot starters and Spring transports; see [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html).
119120

120121
## Next Steps
121122

‎docs/quickstart.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -128,6 +128,8 @@ This is all a client needs. It includes the modern and the legacy client and ser
128128

129129
With the `spring-ai-bom` or the Spring AI starters (`spring-ai-starter-mcp-server-webflux`, `spring-ai-starter-mcp-server-webmvc`, `spring-ai-starter-mcp-client-webflux`), no explicit version is needed.
130130

131+
For the modern client and server, Spring AI 2.1+ provides Boot starters and Spring transports; see [MCP Client Boot Starter](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-client-boot-starter-docs.html) and [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html).
132+
131133
## Your First Client
132134

133135
The SDK has two clients, one for each generation of the protocol; see [Modern or Legacy?](overview.md#modern-or-legacy) to choose. Both examples list the tools of a server at `http://localhost:8080/mcp` and call one of them.

‎docs/server-modern.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ description: Build a stateless MCP server for the 2026-07-28 specification revis
88
!!! note
99
The modern server is available since 2.2.0. Its API, in the `io.modelcontextprotocol.modern` packages,
1010
may change in minor releases until 3.0, and [some parts of the revision](#not-yet-supported) are not
11-
implemented. For production servers that talk to today's clients, use the [legacy server](server.md).
11+
implemented. For clients that speak earlier revisions, use the [legacy server](server.md).
1212
To call a modern server from Java, see the [modern client](client-modern.md).
1313

1414
## Overview
@@ -261,6 +261,11 @@ STDIO has no headers and no `contextExtractor`: handlers always see a transport
261261
so anything that reads identity from `transportContext()`, such as a `requestState`
262262
[principal binding](#securing-requeststate), has nothing to read.
263263

264+
### Spring
265+
266+
Spring WebMVC and WebFlux transports for the modern server, and a Boot starter that configures it, are part
267+
of Spring AI 2.1+, not of this SDK. See [MCP 2026-07-28 Servers](https://docs.spring.io/spring-ai/reference/2.1.0-SNAPSHOT/api/mcp/mcp-modern-server-boot-starter-docs.html) in the Spring AI reference.
268+
264269
### HTTP Security
265270

266271
Authentication and authorization belong in servlet filters in front of `HttpServletMcpTransport`, including
@@ -948,7 +953,6 @@ record TaskChanged(String taskId) implements ServerChange {
948953

949954
- Tasks.
950955
- Logging, which the 2026-07-28 revision deprecates. The modern server never sends log messages.
951-
- Spring WebMVC and WebFlux transports. Spring AI's transports target the legacy server.
952956

953957
For a larger working example, see the
954958
[modern conformance server](https://github.com/modelcontextprotocol/java-sdk/tree/main/conformance-tests/server-servlet-modern),

‎docs/server.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -359,7 +359,7 @@ var capabilities = ServerCapabilities.builder()
359359

360360
### Tool Specification
361361

362-
The Model Context Protocol allows servers to [expose tools](https://spec.modelcontextprotocol.io/specification/2024-11-05/server/tools/) that can be invoked by language models.
362+
The Model Context Protocol allows servers to [expose tools](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) that can be invoked by language models.
363363
The Java SDK allows implementing Tool Specifications with their handler functions.
364364
Tools enable AI models to perform calculations, access external APIs, query databases, and manipulate files.
365365

@@ -681,7 +681,7 @@ var resourceTemplateSpec = new McpServerFeatures.SyncResourceTemplateSpecificati
681681

682682
### Prompt Specification
683683

684-
As part of the [Prompting capabilities](https://spec.modelcontextprotocol.io/specification/2024-11-05/server/prompts/), MCP provides a standardized way for servers to expose prompt templates to clients.
684+
As part of the [Prompting capabilities](https://modelcontextprotocol.io/specification/2025-11-25/server/prompts), MCP provides a standardized way for servers to expose prompt templates to clients.
685685
The Prompt Specification is a structured template for AI model interactions that enables consistent message formatting, parameter substitution, context injection, response formatting, and instruction templating.
686686

687687
=== "Sync"
@@ -846,7 +846,7 @@ Completions can be registered for both `PromptReference` and `ResourceReference`
846846

847847
### Using Sampling from a Server
848848

849-
To use [Sampling capabilities](https://spec.modelcontextprotocol.io/specification/2024-11-05/client/sampling/), connect to a client that supports sampling.
849+
To use [Sampling capabilities](https://modelcontextprotocol.io/specification/2025-11-25/client/sampling), connect to a client that supports sampling.
850850
No special server configuration is needed, but verify client sampling support before making requests.
851851
Learn about [client sampling support](client.md#sampling-support).
852852

0 commit comments

Comments
 (0)