Skip to content

v0.21.0

Latest

Choose a tag to compare

@codeboyzhou codeboyzhou released this 08 Aug 11:38
· 16 commits to main since this release

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-deploy to 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 / target settings to maven.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*.txt dependency 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.target with maven.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/checkout to v7 and codecov/codecov-action to v7.
  • Remove the obsolete FORCE_JAVASCRIPT_ACTIONS_TO_NODE24 compatibility 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

  1. No API migration required - applications using 0.20.0 can update the dependency version without source changes.
  2. Java requirement unchanged - Java 17 remains the minimum supported runtime and build target.
  3. Rebuild recommended - run a full Maven compile/test after upgrading so annotation-generated ComponentProvider entries are refreshed.
  4. 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