Skip to content

Commit 2e75120

Browse files
committed
docs: update MCP SDK version to 0.19.0-SNAPSHOT and change milestone references to release candidate
1 parent 8abf882 commit 2e75120

5 files changed

Lines changed: 20 additions & 20 deletions

File tree

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -66,13 +66,13 @@ This SDK is a lightweight, annotation-based framework that simplifies MCP server
6666
<dependency>
6767
<groupId>io.github.thought2code</groupId>
6868
<artifactId>mcp-annotated-java-sdk</artifactId>
69-
<version>0.18.0</version>
69+
<version>0.19.0-SNAPSHOT</version>
7070
</dependency>
7171
```
7272

7373
**Gradle:**
7474
```gradle
75-
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.18.0'
75+
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.19.0-SNAPSHOT'
7676
```
7777

7878
#### Step 2: Create Configuration File
@@ -288,9 +288,9 @@ The SDK creates **one instance per component class** (no-arg constructor) and re
288288

289289
`McpApplication.run(mainClass, args)` loads `mcp-server.yml` by default; pass a third argument to use another classpath config file name.
290290

291-
#### MCP Java SDK 2.x (milestone)
291+
#### MCP Java SDK 2.x (release candidate)
292292

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.
293+
This project builds on the official [MCP Java SDK](https://github.com/modelcontextprotocol/java-sdk) **2.0.0-RC1**, a **pre-release candidate**. APIs may still change before 2.0 GA — pin dependency versions and re-run tests when upgrading.
294294

295295
- **STREAMABLE** is the supported HTTP transport.
296296

@@ -344,7 +344,7 @@ mvnw.cmd clean test
344344

345345
### Q: Can I use this in production?
346346

347-
**A:** The annotated layer is stable for development and testing, but it depends on the official MCP Java SDK **2.0.0-M3** (a milestone release). Pin versions, run your own integration tests, and expect possible SDK API changes before 2.0 GA before relying on it in production.
347+
**A:** The annotated layer is stable for development and testing, but it depends on the official MCP Java SDK **2.0.0-RC1** (a release candidate). Pin versions, run your own integration tests, and expect possible SDK API changes before 2.0 GA before relying on it in production.
348348

349349
### Q: What does `type: ASYNC` mean?
350350

README.zh-CN.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -67,14 +67,14 @@
6767
<dependency>
6868
<groupId>io.github.thought2code</groupId>
6969
<artifactId>mcp-annotated-java-sdk</artifactId>
70-
<version>0.18.0</version>
70+
<version>0.19.0-SNAPSHOT</version>
7171
</dependency>
7272
```
7373

7474
**Gradle:**
7575

7676
```gradle
77-
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.18.0'
77+
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.19.0-SNAPSHOT'
7878
```
7979

8080
#### 第 2 步:创建配置文件
@@ -290,9 +290,9 @@ SDK 为每个组件类创建 **唯一实例**(无参构造),该类上所
290290

291291
`McpApplication.run(mainClass, args)` 默认加载 `mcp-server.yml`;可通过第三个参数指定 classpath 中的其他配置文件名。
292292

293-
#### MCP Java SDK 2.x(里程碑版本
293+
#### MCP Java SDK 2.x(候选版本
294294

295-
本项目基于官方 [MCP Java SDK](https://github.com/modelcontextprotocol/java-sdk) **2.0.0-M3**,属于 **预发布里程碑**。2.0 正式版发布前 API 可能变更 — 请锁定依赖版本,升级后重新跑集成测试。
295+
本项目基于官方 [MCP Java SDK](https://github.com/modelcontextprotocol/java-sdk) **2.0.0-RC1**,属于 **预发布候选版本**。2.0 正式版发布前 API 仍可能变更 — 请锁定依赖版本,升级后重新跑集成测试。
296296

297297
- 当前支持的 HTTP 传输为 **STREAMABLE**。
298298

@@ -344,7 +344,7 @@ mvnw.cmd clean test
344344

345345
### 问:可以用于生产环境吗?
346346

347-
**答:** 注解层用于开发与测试已较稳定,但依赖官方 MCP Java SDK **2.0.0-M3**里程碑版本)。生产使用前请锁定依赖版本、跑完自己的集成测试,并关注 2.0 正式版发布前可能的 SDK API 变更。
347+
**答:** 注解层用于开发与测试已较稳定,但依赖官方 MCP Java SDK **2.0.0-RC1**候选版本)。生产使用前请锁定依赖版本、跑完自己的集成测试,并关注 2.0 正式版发布前可能的 SDK API 变更。
348348

349349
### 问:`type: ASYNC` 是什么意思?
350350

docs/getting-started.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -19,14 +19,14 @@ This guide will help you build your first MCP server in 5 minutes.
1919
<dependency>
2020
<groupId>io.github.thought2code</groupId>
2121
<artifactId>mcp-annotated-java-sdk</artifactId>
22-
<version>0.18.0</version>
22+
<version>0.19.0-SNAPSHOT</version>
2323
</dependency>
2424
```
2525

2626
### Gradle Dependency
2727

2828
```gradle
29-
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.18.0'
29+
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.19.0-SNAPSHOT'
3030
```
3131

3232
## 5-Minutes Tutorial
@@ -186,9 +186,9 @@ Use **SYNC** by default. Choose **ASYNC** only when your deployment requires the
186186

187187
The SDK creates **one instance per component class** (via a **public no-arg constructor**) and reuses it for all requests. Concurrent MCP calls share that object. Keep components **stateless** or **thread-safe**; avoid unsynchronized per-request instance fields.
188188

189-
### MCP Java SDK 2.x (milestone)
189+
### MCP Java SDK 2.x (release candidate)
190190

191-
This SDK depends on MCP Java SDK **2.0.0-M3** (pre-release). Pin versions and retest when upgrading.
191+
This SDK depends on MCP Java SDK **2.0.0-RC1** (pre-release candidate). Pin versions and retest when upgrading.
192192

193193
- **STREAMABLE** is the supported HTTP transport.
194194

llms-full.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,14 +41,14 @@ The Model Context Protocol (MCP) is a standardized protocol for building servers
4141
<dependency>
4242
<groupId>io.github.thought2code</groupId>
4343
<artifactId>mcp-annotated-java-sdk</artifactId>
44-
<version>0.18.0</version>
44+
<version>0.19.0-SNAPSHOT</version>
4545
</dependency>
4646
```
4747

4848
### Gradle
4949

5050
```gradle
51-
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.18.0'
51+
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.19.0-SNAPSHOT'
5252
```
5353

5454
## Quick Start Tutorial
@@ -468,7 +468,7 @@ public String createUser(
468468
## Important Notes
469469

470470
1. **Entry point**: Use `McpApplication.run()`; component classes are registered when they match the `@McpServerApplication` registration scope.
471-
2. **MCP SDK milestone**: This project depends on MCP Java SDK **2.0.0-M3** (pre-release). Pin versions and retest when upgrading.
471+
2. **MCP SDK release candidate**: This project depends on MCP Java SDK **2.0.0-RC1** (pre-release candidate). Pin versions and retest when upgrading.
472472
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`.
473473
4. **Singleton components**: One instance per component class is shared across concurrent requests. Keep components stateless or thread-safe.
474474
5. **Default Required**: The default `required` value for `@McpToolParam`, `@McpPromptParam`, and `@McpJsonSchemaProperty` is `true`.

llms.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,14 +24,14 @@ A lightweight, annotation-based Java framework that simplifies MCP (Model Contex
2424
<dependency>
2525
<groupId>io.github.thought2code</groupId>
2626
<artifactId>mcp-annotated-java-sdk</artifactId>
27-
<version>0.18.0</version>
27+
<version>0.19.0-SNAPSHOT</version>
2828
</dependency>
2929
```
3030

3131
### Gradle Dependency
3232

3333
```gradle
34-
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.18.0'
34+
implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.19.0-SNAPSHOT'
3535
```
3636

3737
### Create MCP Server
@@ -138,7 +138,7 @@ change-notification:
138138
- Use `McpApplication.run()` as the server entry point; optional third argument overrides the config file name (default `mcp-server.yml`)
139139
- Component registration scope: `basePackageClass` → `basePackage` → main class package; one instance per component class (public no-arg constructor)
140140
- `instructions` must be a non-blank string in `mcp-server.yml` (validated at startup)
141-
- Built on MCP Java SDK **2.0.0-M3** (milestone) — pin versions and retest when upgrading
141+
- Built on MCP Java SDK **2.0.0-RC1** (pre-release candidate) — pin versions and retest when upgrading
142142
- `type: ASYNC` uses the async MCP server API; annotated methods stay blocking Java wrapped in `Mono.fromCallable(...)` — not Project Reactor
143143
- One instance per component class is created and shared across concurrent requests — keep components stateless or thread-safe
144144
- Components are auto-registered when they are within the resolved registration scope

0 commit comments

Comments
 (0)