v0.0.4

Full Changelog: v0.0.3...v0.0.4

v0.0.3

Updating the site URL https://autogentmcp.com/

v0.0.2

MCP Core Java SDK - Release Notes

Version 0.0.2 (July 17, 2025)

🚀 Major Features

Enhanced Spring Boot Integration

• Redesigned Auto-Configuration: Complete rewrite of AutogentMcpAutoConfiguration with improved Spring Boot lifecycle integration
• SmartInitializingSingleton: Implemented proper Spring lifecycle management to ensure endpoints are registered after all beans are fully initialized
• Batch Endpoint Registration: Added support for modern MCP registry servers with batch endpoint registration API (/register/endpoints)
• Application Registration: Streamlined application registration with dedicated updateApplication API

Improved Annotation System

• Enhanced @AutogentTool: Added name and isPublic attributes for better endpoint metadata
• Better HTTP Method Deduction: Improved automatic detection of HTTP methods from Spring mapping annotations
• Robust Parameter Detection: Enhanced automatic detection of path parameters, query parameters, and request bodies

Advanced Logging & Debugging

• Comprehensive Request Logging: Added detailed logging for all HTTP requests to MCP registry including:
  • Complete request details (URL, method, headers, payload)
  • Response status codes and bodies
  • Masked API keys for security
• Enhanced Debug Logging: Added extensive debug logging throughout the registration process
• Endpoint Collection Tracking: Detailed logging of endpoint collection and duplicate detection

🔧 Technical Improvements

Reliability & Error Handling

• Thread-Safe Endpoint Collection: Implemented synchronized endpoint collector with duplicate detection
• Robust Error Handling: Improved error handling with detailed error messages and graceful degradation
• Better Bean Detection: Enhanced logic for finding the main application bean with @EnableAutogentMcp
• Retry Logic: Added better handling of registration failures without breaking application startup

Performance & Compatibility

• Java 8+ Compatibility: Maintained compatibility with Java 8 through Java 21
• Spring Boot 2.x/3.x Support: Ensured compatibility with both Spring Boot 2.x and 3.x versions
• Reduced Dependencies: Streamlined dependencies for better compatibility

Modern HTTP Client

• Apache HttpClient Integration: Replaced Java 11+ HttpClient with Apache HttpClient for better Java 8 compatibility
• Improved Connection Management: Better HTTP connection handling and resource management
• Enhanced Security: Proper handling of API keys and authentication headers

🏗️ Architecture Changes

Registry Client Redesign

• Unified RegistryClient: Consolidated all MCP registry communication into a single, well-tested client
• Batch Operations: Support for batch endpoint registration for improved performance
• Standardized API: Consistent API structure matching modern MCP registry requirements

Spring Integration Improvements

• Lifecycle Management: Proper integration with Spring's bean lifecycle using SmartInitializingSingleton
• Context Awareness: Better integration with Spring's ApplicationContext
• Configuration Management: Improved configuration property handling

📚 Documentation & Examples

Comprehensive Documentation

• Updated README: Complete rewrite with clear setup instructions and examples
• Example Application: Added ExampleMcpApp demonstrating real-world usage
• Configuration Examples: Provided sample application.properties files
• API Documentation: Enhanced JavaDoc comments throughout the codebase

Testing Infrastructure

• Comprehensive Test Suite: Added extensive unit and integration tests
• Mock Framework: Implemented proper mocking for HTTP client testing
• Spring Boot Test Support: Added Spring Boot test configuration for integration testing

🔧 Configuration Changes

Simplified Configuration

# Old configuration (0.0.1)
autogentmcp.base-domain=http://localhost:8080
autogentmcp.security={"type":"apiKey"}

# New configuration (0.0.2)
autogentmcp.registry-url=https://your-mcp-registry/api/registry
autogentmcp.api-key=YOUR_API_KEY
autogentmcp.app-healthcheck-endpoint=/actuator/health
autogentmcp.environment=production

🐛 Bug Fixes

Registration Issues

• Fixed Endpoint Registration: Resolved issue where registerEndpointsBatch was not being called reliably
• Bean Processing Order: Fixed problems with bean processing order affecting endpoint detection
• Duplicate Prevention: Added logic to prevent duplicate endpoint registration

Spring Boot Compatibility

• Annotation Processing: Fixed issues with Spring annotation processing in different versions
• Context Initialization: Resolved problems with application context initialization timing
• Property Injection: Fixed property injection issues in auto-configuration

📦 Dependencies

Updated Dependencies

• Spring Boot: Support for both 2.7.18 and 3.x versions
• Apache HttpClient: Added 4.5.14 for HTTP communication
• Jackson: Updated to 2.13.5 for JSON processing
• JUnit Jupiter: Updated to 5.9.3 for testing

🔄 Migration Guide

From Version 0.0.1 to 0.0.2

1. Update Configuration Properties:

   # Remove old properties
   # autogentmcp.base-domain=...
   # autogentmcp.security=...
   
   # Add new properties
   autogentmcp.registry-url=https://your-mcp-registry/api/registry
   autogentmcp.api-key=YOUR_API_KEY
   autogentmcp.app-healthcheck-endpoint=/actuator/health
   autogentmcp.environment=production

2. Update @AutogentTool Annotations:

   // Add name and isPublic attributes
   @AutogentTool(
       name = "My Tool",
       uri = "/api/tool",
       description = "Tool description",
       isPublic = true
   )

3. Update Maven Dependency:

   <dependency>
       <groupId>com.autogentmcp</groupId>
       <artifactId>mcp-core-java</artifactId>
       <version>0.0.2</version>
   </dependency>

🎯 Breaking Changes

• Configuration Properties: Property names have been updated for clarity
• Registry API: Now uses batch endpoint registration instead of individual registration
• HTTP Client: Switched from Java 11+ HttpClient to Apache HttpClient

🔮 Future Improvements

• Async Registration: Support for asynchronous endpoint registration
• Health Check Integration: Built-in health check endpoint for MCP monitoring
• Metrics Collection: Integration with Spring Boot Actuator for metrics
• Security Enhancements: Support for additional authentication methods

---

📞 Support

For questions, issues, or contributions:

• GitHub Issues: https://github.com/autogentmcp/mcp-core-java/issues
• Documentation: See README.md for detailed usage instructions
• Examples: Check the examples package for working code samples

---

Full Changelog: View on GitHub

v0.0.1

First release, this will be the base version which will be improved upon in time.