0.21.0 (2026-08-08)
Highlights
- Astro Starlight documentation site - replaced the previous MkDocs stack with Astro 7 and Starlight, including a custom dark theme, project color palette, Liberation Mono code font, responsive landing page, search, sitemap, and GitHub Pages deployment.
- Simplified Chinese documentation - added complete Chinese versions of the landing page, getting-started guide, and core-components reference, with localized navigation and per-page language switching.
- GitHub Actions Pages deployment - migrated documentation publishing from
mkdocs gh-deployto the official GitHub Pages artifact workflow, while continuing to build documentation for pull requests. - Modernized dependency automation - added Dependabot coverage for Maven, GitHub Actions, and the documentation npm workspace, replacing build-time dependency-update checks.
- Safer Java 17 compilation - switched from separate
source/targetsettings tomaven.compiler.release, ensuring builds on newer JDKs cannot accidentally use APIs newer than Java 17. - Dependency and action refresh - upgraded Jetty, Logback, JUnit, Maven plugins, and the JavaScript actions used by CI and release workflows.
Dependency
<dependency>
<groupId>io.github.thought2code</groupId>
<artifactId>mcp-annotated-java-sdk</artifactId>
<version>0.21.0</version>
</dependency>implementation 'io.github.thought2code:mcp-annotated-java-sdk:0.21.0'Built against MCP Java SDK 2.0.0. Requires Java 17+ and Maven 3.9.16+ (use ./mvnw).
Changes since 0.20.0
Breaking / API Changes
- No runtime API breaking changes in this release.
Documentation
- Replace MkDocs and Material for MkDocs with Astro 7.2.0 and Starlight 0.41.7.
- Add a redesigned project landing page inspired by the JavaUp documentation style and color palette.
- Add English and Simplified Chinese locales with localized navigation and matching page routes.
- Add complete Chinese translations for overview, getting started, and core component documentation.
- Use the bundled Liberation Mono family for code and monospace content.
- Correct documentation URLs in Javadocs and align server-mode terminology.
- Update README, documentation, and
llms*.txtdependency snippets to 0.21.0.
Build & Dependencies
- Upgrade Jetty EE10 Servlet from 12.1.10 to 12.1.12.
- Upgrade Logback from 1.5.34 to 1.6.1.
- Upgrade JUnit from 6.1.0 to 6.1.2.
- Upgrade Central Publishing Maven Plugin from 0.10.0 to 0.11.0.
- Upgrade SpotBugs Maven Plugin from 4.10.2.0 to 4.10.3.0.
- Upgrade Spotless Maven Plugin from 3.6.0 to 3.9.0.
- Remove the Versions Maven Plugin from the validation lifecycle and use Dependabot for scheduled update discovery.
- Replace
maven.compiler.source/maven.compiler.targetwithmaven.compiler.release. - Reuse the shared Java version property in Maven Enforcer configuration.
CI and Release
- Add weekly Dependabot checks for Maven, GitHub Actions, and npm dependencies.
- Upgrade
actions/checkoutto v7 andcodecov/codecov-actionto v7. - Remove the obsolete
FORCE_JAVASCRIPT_ACTIONS_TO_NODE24compatibility flag after GitHub-hosted runners moved to Node.js 24 by default. - Build and deploy the documentation site with the official GitHub Pages Actions flow.
Tests & Quality
- Verify the release with the full Maven build, including 122 tests, Spotless, SortPom, Maven Enforcer, SpotBugs, Javadocs, and source JAR generation.
- Verify all English and Chinese documentation routes with the Astro production build and Pagefind search indexing.
Upgrade notes
- No API migration required - applications using 0.20.0 can update the dependency version without source changes.
- Java requirement unchanged - Java 17 remains the minimum supported runtime and build target.
- Rebuild recommended - run a full Maven compile/test after upgrading so annotation-generated
ComponentProviderentries are refreshed. - Documentation deployment - repository maintainers should use GitHub Pages with the source set to GitHub Actions for the new Astro deployment workflow.
Full changelog: v0.20.0...v0.21.0