v0.8.4

Docs

• Add Java doc for all classes

Dependencies

• Update official MCP Java SDK from 0.13.0 to 0.13.1
• Update org.jetbrains:annotations from 26.0.2 to 26.0.2-1
• Update org.eclipse.jetty.ee10:jetty-ee10-servlet from 12.1.0 to 12.1.1
• Update org.mockito:mockito-core from 5.19.0 to 5.20.0

Full Changelog

v0.8.3...v0.8.4

v0.8.3

Enhancement

• IllegalArgumentException: object is not an instance of declaring class (when split the tool methods into different classes) (#7)

Dependencies

• Update official MCP Java SDK from 0.12.1 to 0.13.0

Full Changelog

v0.8.2...v0.8.3

v0.8.2

Bug Fix

• Tools calls are getting mixed up (Streamable Http). Wrong tool method is invoked. (#5)

Enhancement

• NullPointerException for tools that return void. (#6)

Dependencies

• Update official MCP Java SDK from 0.11.3 to 0.12.1

Full Changelog

v0.8.1...v0.8.2

v0.8.1

What's Changed

• Update official MCP Java SDK version to 0.11.3 for integrating some bug fixes.

Full Changelog

v0.8.0...v0.8.1

v0.8.0

Feature

• Add default mcp-server configuration file with streamable settings.

Dependencies

• Update org.jetbrains:annotations from 24.0.0 to 26.0.2
• Update com.google.inject:guice from 6.0.0 to 7.0.0
• Update com.fasterxml.jackson.dataformat:jackson-dataformat-yaml from 2.18.3 to 2.19.2
• Update org.eclipse.jetty.ee10:jetty-ee10-servlet from 12.0.18 to 12.1.0
• Update org.junit.jupiter:junit-jupiter from 5.10.2 to 5.13.4
• Update org.mockito:mockito-core from 5.18.0 to 5.19.0

Breaking Changes

Warning

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

Deprecated & Removed

@Deprecated(since = "0.8.0", forRemoval = true)
public @interface McpResources {}

@Deprecated(since = "0.8.0", forRemoval = true)
public @interface McpPrompts {}

@Deprecated(since = "0.8.0", forRemoval = true)
public @interface McpTools {}

Full Changelog

v0.7.0...v0.8.0

v0.7.0

Features

• Add support for Streamable HTTP server.
• Add SpotBugs plugin for static code analysis.

Dependencies

• Update native MCP Java SDK from 0.11.1 to 0.11.2

Breaking Changes

Warning

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

Deprecated

public record McpServerConfiguration(
    @Deprecated(since = "0.7.0", forRemoval = true)
    @JsonProperty("stdio") boolean stdio // use new field `mode` instead
)

Full Changelog

v0.6.0...v0.7.0

v0.6.0

Features

• Introduce google-java-format to unify code style.
• Add project documents and site powered by Material for MkDocs.
• Add title attribute to MCP prompt, resource and tool specifications.
• Introduce McpI18nEnabled annotation to enable/disable i18n support.
• Introduce McpServerApplication annotation to replace McpComponentScan annotation.

Dependencies

• Add spotless-maven-plugin 2.46.1
• Add maven-compiler-plugin 3.14.0
• Update native MCP Java SDK from 0.10.0 to 0.11.1

Breaking Changes

Warning

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

Deprecated

@Deprecated(since = "0.6.0", forRemoval = true)
public @interface McpComponentScan // Use @McpServerApplication instead

@Deprecated(since = "0.6.0", forRemoval = true)
String descriptionI18nKey() default StringHelper.EMPTY; // Use description() instead

Full Changelog

v0.5.0...v0.6.0

v0.5.0

Features

• Add support for hot-reload on configuration file changed.
• Add i18n support for MCP server component description.

Bug Fixes

• Avoid Sinks.EmitResult.FAIL_NON_SERIALIZED during message transmission in the low-level MCP SDK.

Enhancements

• Introduce Guice framework to enhance dependency injection and reduce explicit reflections.
• Use McpAsyncServer instead of McpSyncServer in MCP server components registration.
• Avoid HTTP port occupation in unit tests.

Breaking Changes

Warning

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

Deprecated

The following APIs in McpServers are no longer recommended for use.

@Deprecated(since = "0.5.0", forRemoval = true)
public void startSyncStdioServer(McpServerInfo serverInfo)

@Deprecated(since = "0.5.0", forRemoval = true)
public void startSyncSseServer(McpSseServerInfo serverInfo, McpHttpServerStatusListener<McpSyncServer> listener)

@Deprecated(since = "0.5.0", forRemoval = true)
public void startSyncSseServer(McpSseServerInfo serverInfo)

Full Changelog

v0.4.0...v0.5.0

v0.4.0

Features

• Add support for MCP server requestTimeout option.
• Add support for MCP server yaml configuration.
• Add support for complex JSON schema definitions.
• Add new API McpServers.startServer().

Bug Fixes

• Parameters Display Order (PR #2): Fixed the parameters display order issue in MCP Inspector v0.12.0.

Dependencies

• Update native MCP Java SDK from 0.9.0 to 0.10.0

Deprecated

The following APIs in McpServers are no longer recommended for use due to some new features of MCP Java SDK 0.10.0.

@Deprecated(since = "0.4.0")
public void startSyncStdioServer(String name, String version, String instructions)

Full Changelog

0.3.x...0.4.x

Contributors

We'd like to thank the following contributors for their work on this release:

• steveGuRen (@steveGuRen)
• Jason Ryan (@codeboyzhou)

v0.3.0

Features

• MCP prompt is now supported

Breaking Changes

Warning

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

Full Changelog

0.2.x...0.3.x