Skip to content

v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@chemicL chemicL released this 23 Feb 13:20
· 3 commits to main since this release
v1.0.0
3c87155

MCP Java SDK 1.0.0

We are pleased to announce the 1.0.0 GA release of the MCP Java SDK — the official Java SDK for Model Context Protocol servers and clients, maintained in collaboration with Spring AI.

Major Features

  • MCP Protocol Implementation — Spec-compliant implementation of the Model Context Protocol, including tools, resources, prompts, sampling, elicitation, and progress tracking.
  • Synchronous and Asynchronous APIs — First-class support for both blocking (McpSyncClient / McpSyncServer) and reactive (McpAsyncClient / McpAsyncServer) programming models.
  • Official Transport Options — STDIO, Servlet-based (Streamable HTTP and HTTP/SSE) transports out of the box.
  • Pluggable JSON Serialization — Supports both Jackson 2 and Jackson 3, with Jackson 3 as the default. Integration is decoupled so projects can supply their own binding.
  • MCP Protocol Version Negotiation — Clients and servers automatically negotiate the highest mutually supported protocol version at connection time.
  • Authorization & Security — DNS rebinding protection, Origin header validation, and conformance-tested OAuth/auth flows via relevant hooks.
  • OSGi Support — All modules ship with correct OSGi bundle manifests for use in Eclipse/OSGi runtimes.
  • BOM for Dependency Management — mcp-bom keeps all SDK module versions aligned with a single import.
  • MCP Test Module — Reusable test utilities and a conformance test suite for validating server and client implementations.

Spec Compliance

The SDK is compliant with the 2025-06-18 MCP specification and supports protocol version negotiation across 2024-11-05, 2025-03-26, and 2025-06-18.

Work towards 2025-11-25 spec compliance is actively in progress. Key features in that revision include tasks (durable request tracking), tool calling in sampling, URL elicitation, icon metadata, enhanced JSON Schema support, and updated OAuth/security flows. See the Roadmap for details.

Stability in the 1.x Line

With 1.0.0, the SDK transitions to a stable, semantically versioned release line. The project follows Semantic Versioning 2.0.0:

  • Patch releases (1.0.x) deliver backward-compatible bug fixes.
  • Minor releases (1.x.0) deliver new, backward-compatible features — including new MCP spec support.
  • Major releases (2.x) are reserved for breaking API changes or MCP spec revisions that require code changes on the caller side.

Breaking changes are always documented with migration instructions, APIs are deprecated before removal, and pull requests containing breaking changes are labeled accordingly. See VERSIONING.md for the full policy.

What's Changed in 1.0.0

Spring Transports Move to Spring AI 2.0

  • Moved mcp-spring-webflux and mcp-spring-webmvc to Spring AI 2.0 (#805)

API Cleanup

  • Removed all APIs deprecated during the RC cycle to establish a clean stable baseline (#807)

Security & Conformance

  • Added authorization conformance testing using Spring Security (#806)
  • Updated SECURITY.md to use GitHub Security Advisories (#801)

OSGi

  • Fixed and simplified OSGi manifest.mf generation (#792)

Governance & Community

  • Added governance documentation (#808)
  • Updated community support channel to Stack Overflow (#824)

New Contributors

Full Changelog: v0.18.1...v1.0.0

Assets 2
Loading