You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -297,8 +292,7 @@ The SDK creates **one instance per component class** (no-arg constructor) and re
297
292
298
293
This project builds on the official [MCP Java SDK](https://github.com/modelcontextprotocol/java-sdk) **2.0.0-M3**, a **pre-release milestone**. APIs may change before 2.0 GA — pin dependency versions and re-run tests when upgrading.
299
294
300
-
- **STREAMABLE** is the recommended HTTP transport for new projects.
301
-
- **SSE** (`ServerMode.SSE`, `McpSseServer`, `ServerSse`, `sse.*` in YAML) is **deprecated with `forRemoval = true` since 0.16.0** and scheduled for removal in a future release. Existing deployments may still use it for compatibility; migrate to **STREAMABLE** (`McpStreamableServer`, `streamable.*`).
295
+
- **STREAMABLE** is the supported HTTP transport.
302
296
303
297
## 🏗️ Project Structure
304
298
@@ -377,7 +371,6 @@ mvnw.cmd clean test
377
371
**A:**
378
372
- **STDIO**: For CLI tools and local development
379
373
- **STREAMABLE**: For web applications and production deployments (recommended)
380
-
- **SSE**: Deprecated since 0.16.0 (`forRemoval`); use STREAMABLE and `streamable.*` instead of `sse.*`
Copy file name to clipboardExpand all lines: docs/getting-started.md
+3-25Lines changed: 3 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -133,24 +133,7 @@ Based on standard input/output communication, suitable for CLI tools and local d
133
133
mode: STDIO
134
134
```
135
135
136
-
### 2. SSE (Server-Sent Events) Mode
137
-
138
-
!!! warning "Deprecated (for removal since 0.16.0)"
139
-
HTTP SSE mode (`mode: SSE`, `sse.*` config, `McpSseServer`, `ServerMode.SSE`) is deprecated with **`forRemoval = true`** since **0.16.0** and scheduled for removal in a future release. Use **STREAMABLE** mode for new projects (`McpStreamableServer`, `streamable.*`).
140
-
141
-
HTTP-based real-time communication (legacy).
142
-
143
-
```yaml
144
-
# mcp-server.yml
145
-
mode: SSE
146
-
sse:
147
-
port: 8080
148
-
endpoint: /sse
149
-
message-endpoint: /mcp/message
150
-
base-url: http://localhost:8080
151
-
```
152
-
153
-
### 3. STREAMABLE Mode
136
+
### 2. STREAMABLE Mode
154
137
155
138
HTTP streaming for web applications, recommended for production.
@@ -211,8 +190,7 @@ The SDK creates **one instance per component class** (via a **public no-arg cons
211
190
212
191
This SDK depends on MCP Java SDK **2.0.0-M3** (pre-release). Pin versions and retest when upgrading.
213
192
214
-
- **STREAMABLE** is the recommended HTTP transport for new projects.
215
-
- **SSE** (`ServerMode.SSE`, `McpSseServer`, `ServerSse`, `sse.*` in YAML) is **deprecated with `forRemoval = true` since 0.16.0** and scheduled for removal in a future release. Existing deployments may still use it for compatibility; migrate to **STREAMABLE** (`McpStreamableServer`, `streamable.*`).
|**STDIO**| Standard input/output communication | CLI tools, local development |
53
-
|**SSE**| Server-Sent Events (HTTP-based) | Deprecated since 0.16.0 (`forRemoval`); use STREAMABLE |
54
53
|**STREAMABLE**| HTTP streaming | Web applications, recommended for production |
55
54
56
55
## Runtime notes
57
56
58
57
-**ASYNC vs SYNC** — `type: ASYNC` selects the async MCP server API; your annotated methods stay blocking Java wrapped in `Mono.fromCallable(...)`. See [Getting Started — Runtime model](./getting-started.md#runtime-model-and-stability).
59
58
-**Singleton components** — one instance per component class, shared across concurrent requests; keep handlers stateless or thread-safe.
60
-
-**Required YAML** — `instructions` must be non-blank; when `mode` is `STREAMABLE` or `SSE`, the matching transport section must be present and complete.
61
-
-**MCP SDK 2.0.0-M3** — built on a pre-release milestone; pin versions and prefer **STREAMABLE** over **SSE** (deprecated with `forRemoval = true` since 0.16.0).
59
+
-**Required YAML** — `instructions` must be non-blank; when `mode` is `STREAMABLE`, the `streamable` transport section must be present and complete.
60
+
-**MCP SDK 2.0.0-M3** — built on a pre-release milestone; pin versions and retest when upgrading.
Copy file name to clipboardExpand all lines: llms-full.txt
+6-25Lines changed: 6 additions & 25 deletions
Original file line number
Diff line number
Diff line change
@@ -283,7 +283,6 @@ If `mode` is omitted in `mcp-server.yml`, the server defaults to **STREAMABLE**.
283
283
| Mode | Description | Use Case |
284
284
|------|-------------|----------|
285
285
| **STDIO** | Standard input/output communication | CLI tools, local development |
286
-
| **SSE** | Server-Sent Events (HTTP-based) | Deprecated since 0.16.0 (`forRemoval`); use STREAMABLE |
287
286
| **STREAMABLE** | HTTP streaming | Web applications, recommended for production |
288
287
289
288
### STDIO Mode
@@ -292,19 +291,6 @@ If `mode` is omitted in `mcp-server.yml`, the server defaults to **STREAMABLE**.
292
291
mode: STDIO
293
292
```
294
293
295
-
### SSE Mode (Deprecated since 0.16.0, for removal)
296
-
297
-
HTTP SSE transport (`mode: SSE`, `sse.*`, `McpSseServer`, `ServerMode.SSE`) is deprecated with **`forRemoval = true`** since **0.16.0** and scheduled for removal in a future release. Migrate to **STREAMABLE** for new projects.
298
-
299
-
```yaml
300
-
mode: SSE
301
-
sse:
302
-
port: 8080
303
-
endpoint: /sse
304
-
message-endpoint: /mcp/message
305
-
base-url: http://localhost:8080
306
-
```
307
-
308
294
### STREAMABLE Mode
309
295
310
296
```yaml
@@ -321,7 +307,7 @@ streamable:
321
307
| Property | Description | Default |
322
308
|----------|-------------|---------|
323
309
| `enabled` | Enable/disable MCP server | `true` |
1. **Entry point**: Use `McpApplication.run()`; component classes are registered when they match the `@McpServerApplication` registration scope.
489
-
2. **Deprecated SSE (for removal since 0.16.0)**: HTTP SSE mode and related APIs (`ServerMode.SSE`, `McpSseServer`, `ServerSse`, `sse.*` config) are deprecated with `forRemoval = true` since 0.16.0. Use STREAMABLE mode (`McpStreamableServer`, `streamable.*`) for new HTTP projects.
490
-
3. **MCP SDK milestone**: This project depends on MCP Java SDK **2.0.0-M3** (pre-release). Pin versions and retest when upgrading.
491
-
4. **ASYNC is not reactive**: `type: ASYNC` selects the async MCP server API; handlers wrap blocking Java methods in `Mono.fromCallable(...)`. Annotated methods do not return `Mono`/`Flux`.
492
-
5. **Singleton components**: One instance per component class is shared across concurrent requests. Keep components stateless or thread-safe.
493
-
6. **Default Required**: The default `required` value for `@McpToolParam`, `@McpPromptParam`, and `@McpJsonSchemaProperty` is `true`.
494
-
7. **Required YAML fields**: `instructions` must be non-blank. When `mode` is `STREAMABLE` or `SSE`, the matching transport section must be present and complete.
471
+
2. **MCP SDK milestone**: This project depends on MCP Java SDK **2.0.0-M3** (pre-release). Pin versions and retest when upgrading.
472
+
3. **ASYNC is not reactive**: `type: ASYNC` selects the async MCP server API; handlers wrap blocking Java methods in `Mono.fromCallable(...)`. Annotated methods do not return `Mono`/`Flux`.
473
+
4. **Singleton components**: One instance per component class is shared across concurrent requests. Keep components stateless or thread-safe.
474
+
5. **Default Required**: The default `required` value for `@McpToolParam`, `@McpPromptParam`, and `@McpJsonSchemaProperty` is `true`.
475
+
6. **Required YAML fields**: `instructions` must be non-blank. When `mode` is `STREAMABLE`, the `streamable` transport section must be present and complete.
Copy file name to clipboardExpand all lines: llms.txt
-2Lines changed: 0 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -110,7 +110,6 @@ If `mode` is omitted in `mcp-server.yml`, the server defaults to **STREAMABLE**.
110
110
|------|-------------|----------|
111
111
| STDIO | Standard input/output | CLI tools, local development |
112
112
| STREAMABLE | HTTP streaming | Web applications, production (recommended) |
113
-
| SSE | Server-Sent Events | Deprecated since 0.16.0 (`forRemoval`); use STREAMABLE |
114
113
115
114
## Configuration (mcp-server.yml)
116
115
@@ -139,7 +138,6 @@ change-notification:
139
138
- Use `McpApplication.run()` as the server entry point; optional third argument overrides the config file name (default `mcp-server.yml`)
140
139
- Component registration scope: `basePackageClass` → `basePackage` → main class package; one instance per component class (public no-arg constructor)
141
140
- `instructions` must be a non-blank string in `mcp-server.yml` (validated at startup)
142
-
- SSE mode and related APIs (`ServerMode.SSE`, `McpSseServer`, `ServerSse`, `sse.*` config) are deprecated with `forRemoval = true` since 0.16.0; use STREAMABLE for new HTTP deployments
143
141
- Built on MCP Java SDK **2.0.0-M3** (milestone) — pin versions and retest when upgrading
144
142
- `type: ASYNC` uses the async MCP server API; annotated methods stay blocking Java wrapped in `Mono.fromCallable(...)` — not Project Reactor
145
143
- One instance per component class is created and shared across concurrent requests — keep components stateless or thread-safe
0 commit comments