MCP Java SDK Bug-fix Release
🔧 Protocol Compatibility & Transport Improvements
Multi-Protocol Version Support (#444)
- Breaking Change: Replaced
protocolVersion()
method withprotocolVersions()
returningList<String>
- Added backward compatibility for MCP servers returning older protocol versions
- Streamable HTTP clients now support both
2024-11-05
and2025-03-26
protocol versions - Introduced
ProtocolVersions
interface with centralized version constants - Fixes compatibility issues with MCP servers that incorrectly return
2024-11-05
instead of2025-03-26
HTTP Header Standardization (#449, #448)
- Use
Last-Event-ID
instead oflast-event-id
(HTML spec compliance) - Removed duplicate
MCP_PROTOCOL_VERSION
header definitions
🐛 Bug Fixes
Logging Improvements (#457)
- Downgraded unhandled notification logging from error to warning level
- Enhanced logging context by including full notification object instead of just method name
- Affects
McpClientSession
,McpServerSession
, andMcpStreamableServerSession
Client Initialization Fix (#438)
- Fixed "Client failed to initialize by explicit API call" error
- Corrected stream handling in message delivery for empty responses (notify cases)
- Ensured proper
sink.next()
execution in all scenarios
🔍 Completed Changes
- 5 pull requests successfully merged or closed
- Focus on protocol compatibility, bug fixes, and consistency improvements
Note: This release includes important protocol compatibility improvements and some breaking API changes. Please review the migration guide before upgrading.
Full Changelog: v0.11.0...v0.11.1