v0.14.0

0.14.0 (2026-05-15)

🚀 Breaking Changes

• Remove deprecated McpServers — The deprecated McpServers type has been removed. Use McpApplication.run(Class, String[]) as the only supported entry point.
• Rename McpServer to AnnotatedMcpServer — If you referenced McpServer from this library, update imports and types to AnnotatedMcpServer.

Migration Guide

If you still used McpServers (deprecated since v0.13.0):

Before (removed in v0.14.0):

McpServers.run(MyMcpServer.class, args).startStdioServer(configuration);

After (v0.14.0):

McpApplication.run(MyMcpServer.class, args);

✨ Features

• Add asynchronous MCP server support alongside synchronous servers
• Introduce McpApplicationContext to eliminate global mutable application state
• Introduce McpComponentInstanceFactory to decouple MCP component instance creation
• Add validation for merged MCP server configuration (base mcp-server.yml + profile overlays)
• Centralize default configuration in McpServerDefaults
• Add a unified McpServerError contract for categorized server-side failures

🔧 Improvements

• Restructure MCP component registration with shared sync/async abstractions (AbstractDualModeComponentRegistrar)
• Replace MethodCache with MethodMetadata for reflected method metadata
• Centralize Jetty-based HTTP server startup logic
• Refine McpApplication initialization and default configuration loading
• Enhance ServerMode and ServerType enums (including human-readable descriptions)
• Align Invocation / tool invocation with the unified error contract

🐛 Bug Fixes

• Restore thread interrupted status when joining the Jetty server fails
• Improve error handling when the MCP server fails to start

📦 Dependencies

• MCP SDK: Update to 1.1.2 (via mcp-bom)
• Jetty: Update to 12.1.9
• JUnit: Update to 6.1.0-RC1
• Mockito: Update to 5.23.0
• SpotBugs Maven Plugin: Update to 4.9.8.3
• Maven Enforcer Plugin: Update to 3.6.2
• SortPOM Maven Plugin: 4.0.0

🔨 Build & CI

• Enforce Maven 3.9.13+ when building; use ./mvnw / mvnw.cmd for a reproducible toolchain (aligned with CI)
• Bump assorted Maven plugin and dependency versions

📚 Documentation

• Align README and docs/ with implementation (YAML kebab-case keys, STREAMABLE defaults, SSE/streamable settings, annotation defaults, Completions API, structured content, and error-handling guidance)
• Refresh llms.txt and llms-full.txt for LLM-oriented discovery
• Clarify how to run sample apps (IDE / classpath vs expecting a single fat JAR)

🙏 What's Changed

This release completes the move to McpApplication-centric startup, adds async MCP server support, and tightens configuration validation and error reporting. Documentation and LLM-oriented files are synchronized with the code to reduce integration mistakes when configuring transports, completions, and tools.

v0.13.0

0.13.0 (2026-03-08)

🚀 Breaking Changes

• Deprecate McpServers class in favor of McpApplication - The McpServers class is now deprecated and will be removed in a future version. Use McpApplication.run() instead for a simpler API.

Migration Guide

Before (v0.12.x):

McpServers.run(MyMcpServer.class, args).startStdioServer(configuration);

After (v0.13.0):

McpApplication.run(MyMcpServer.class, args);

✨ Features

• Add documentation setup with MkDocs and GitHub Pages deployment
• Introduce McpApplication as the new main entry point for MCP servers

🔧 Improvements

• Rename InvocationResult to Invocation with improved error handling
• Use Duration for time interval configuration
• Remove McpServerJsonProcessingException and handle null cases gracefully
• Improve logging messages and server initialization

🐛 Bug Fixes

• Fix CI: add execute permission to ./mvnw
• Fix annotations: change default required value to true for McpToolParam, McpPromptParam, McpJsonSchemaProperty

📦 Dependencies

• MCP SDK: Update to 1.0.0 (official stable release)
• Jetty: Update to 12.1.7
• JUnit: Update to 6.1.0-M1
• Mockito: Update to 5.22.0
• Logback: Update to 1.5.32
• JetBrains Annotations: Update to 26.1.0

🔨 Build & CI

• Add Maven wrapper files for project initialization
• Add maven-enforcer-plugin to enforce Maven 3.9.0+ and Java 17+
• Add versions-maven-plugin for dependency update checking
• Update Maven plugins to latest versions:
  • maven-compiler-plugin: 3.15.0
  • maven-gpg-plugin: 3.2.8
  • maven-javadoc-plugin: 3.12.0
  • maven-source-plugin: 3.4.0
  • maven-surefire-plugin: 3.5.5
  • spotbugs-maven-plugin: 4.9.8.2
  • spotless-maven-plugin: 3.3.0
  • jacoco-maven-plugin: 0.8.14
  • central-publishing-maven-plugin: 0.10.0

📚 Documentation

• Add comprehensive documentation site with MkDocs
• Update README for v0.13.0 release
• Add detailed Javadoc for McpApplication.startMcpServer() method
• Update badge labels and add commit activity

🙏 What's Changed

This release marks a significant milestone with the official MCP SDK v1.0.0 support and introduces a cleaner API through McpApplication. The documentation has been greatly improved with a dedicated documentation site.

v0.12.1

0.12.1 (2026-01-23)

Features

• Change default required value to true for McpToolParam, McpPromptParam, McpJsonSchemaProperty (6b962e5)
• Improve logging messages and server initialization (e8e5efb)

Dependencies

• Update official mcp-sdk version to 0.17.2

v0.12.0

New Release: Internal refactor edition

Breaking Changes

Warning

The deprecated APIs in v0.11.0 have been removed in this version, new APIs are recommended to use.
Also see https://github.com/thought2code/mcp-annotated-java-sdk/releases/tag/v0.11.0 for more details.

Major Changes

• Refactor and simplify server implementation and configuration.
• Remove Guice dependency and refactor server components.
• Add detailed logging for server operations.
• Prevent duplicate initialization of singletons.

Dependencies

• Update logback-classic version from 1.5.24 to 1.5.25
• Update jackson-dataformat-yaml from 2.20.1 to 3.0.3

Full Changelog

v0.11.0...v0.12.0

v0.11.0

Transitional Release: Prepare for major breaking changes in future versions.

Deprecated

@Deprecated(since = "0.11.0", forRemoval = true)
public class McpServerInfo

@Deprecated(since = "0.11.0", forRemoval = true)
public class McpSseServerInfo extends McpServerInfo

@Deprecated(since = "0.11.0", forRemoval = true)
public class McpStreamableServerInfo extends McpServerInfo

@Deprecated(since = "0.11.0", forRemoval = true)
public void startStdioServer(McpServerInfo serverInfo)

@Deprecated(since = "0.11.0", forRemoval = true)
public void startSseServer(McpSseServerInfo serverInfo)

@Deprecated(since = "0.11.0", forRemoval = true)
public void startStreamableServer(McpStreamableServerInfo serverInfo)

Dependencies

• Update jackson-dataformat-yaml version from 2.17.0 to 2.20.1
• Update jetty version from 12.1.1 to 12.1.5
• Update junit version from 6.0.0 to 6.0.2
• Update logback version from 1.5.18 to 1.5.24
• Update mockito version from 5.20.0 to 5.21.0

Full Changelog

v0.10.0...v0.11.0

v0.10.0

Breaking Changes

Warning

• The groupId has been changed to io.github.thought2code now.
• The artifactId has been changed to mcp-annotated-java-sdk now.
• The common prefix of java package has been changed to com.github.thought2code now.

Dependencies

• Update official MCP Java SDK from 0.17.0 to 0.17.1

Full Changelog

v0.9.1...v0.10.0

v0.9.1

Docs

Completely rewritten the README.md and project docs

Dependencies

• Update official MCP Java SDK from 0.16.0 to 0.17.0

Full Changelog

v0.9.0...v0.9.1

v0.9.0

Features

• Enhance i18n support with configurable resource bundle base name.
• Change default metadata values to use name attribute instead of Not specified.
• Add profile support for multi-environments development.
• Refactor configuration loading and validation.
• Add builder pattern support for configuration record classes.
• Add subscribe-resource capability support in McpServerCapabilities.
• Add getDefault() methods for configuration record classes.
• Add prompt and resource completion support with annotations and server components.

Dependencies

• Update official MCP Java SDK from 0.14.0 to 0.16.0

Full Changelog

v0.8.6...v0.9.0

v0.8.6

Bug Fixes

• Mcp tools params type is Number will error. (#8)
• Mcp tools params type is double or Double will error. (#8)

Features

• Add support for outputSchema and structuredContent in MCP tools. (#9)

Full Changelog

v0.8.5...v0.8.6

v0.8.5

Dependencies

• Update official MCP Java SDK from 0.13.1 to 0.14.0
• Update org.junit.jupiter:junit-jupiter from 5.13.4 to 6.0.0

Full Changelog

v0.8.4...v0.8.5