docs: Add comprehensive JavaDoc documentation to McpSchema

This enhances API documentation and developer experience when working
with the MCP Java SDK schema definitions.

Signed-off-by: Christian Tzolov <christian.tzolov@broadcom.com>

Author: tzolov