🚀 Symfony MCP Server v1.5.0 - Enhanced Protocol Support & Developer Experience

[klapaudius]

We're excited to announce the release of Symfony MCP Server v1.5.0, bringing significant improvements to protocol handling, developer experience, and architecture. This release introduces support for the latest MCP Protocol version 2025-06-18 while maintaining backward compatibility.

🎯 Key Highlights

🌟 New MCP Protocol Version Support

• Added MCP Protocol Version 2025-06-18 - Stay current with the latest Model Context Protocol specifications
• Enhanced protocol version handling with automatic version negotiation based on client capabilities
• Improved batch request handling - Batch requests are now exclusively supported in protocol version 2025-03-26, ensuring proper protocol compliance

🔧 Enhanced Developer Experience

New Migration Command

php bin/console mcp:migrate-tool-schema \\App\\MCP\\Tools\\MyLegacyTool

A new command to help developers migrate their existing tools to the new StructuredSchema system, making upgrades seamless and automated.

StructuredSchema Revolution

• Issue Implements Structured Tool Output from MCP specification version 2025-06-18 #48: Complete migration from legacy schemas to StructuredSchema for input/output validation
• Better type safety and validation for tool parameters
• Improved developer experience with clearer schema definitions
• Comprehensive documentation with updated examples

🏗️ Architecture Improvements

• Refactored StreamableHttpController with intelligent protocol version detection via headers
• Enhanced validation for batch requests based on protocol version compatibility
• Issue add name and title in returned json on resource/call #49: Added name and title fields in returned JSON for resource/call operations
• Updated TransportFactory to support multiple protocol versions seamlessly
• Better separation of concerns in request handling logic
• Proper type declarations and final method modifiers where appropriate

🐛 Reliability Enhancements

• Improved error handling for invalid protocol versions with proper JSON-RPC error codes
• Comprehensive unit tests added for RedisAdapter, ToolParamsValidator, and new components
• Better Redis extension mocking in test environments for improved CI/CD compatibility

📚 Documentation & Usability

• New MCP features status table in README for better feature visibility
• Updated tool documentation showcasing StructuredSchema usage patterns
• Enhanced examples demonstrating best practices for modern MCP development
• Comprehensive test coverage with new unit tests for critical components
• Backward compatibility maintained for existing implementations

🔄 Migration Guide

For existing users, this release maintains full backward compatibility. However, to take advantage of the new features:

1. Use the new migration command to update your tools to StructuredSchema

2. Review protocol version usage - batch requests are now limited to protocol version 2025-03-26

🙏 Contributors

Special thanks to all contributors who made this release possible through bug reports, feature requests, and code contributions.

---

Full Changelog: View all changes since v1.4.0

Installation:

composer require klapaudius/symfony-mcp-server:^1.5.0

Documentation: Check out our updated documentation and building tools guide

---

Happy coding! 🎉