Expose Nullable / Nonnull on public properties / methods

Expected Behavior

Certain fields in MCP are mandatory, some are optional. I would expect to be able to know whether a certain property or function could be or return null from the Java SDK API.

Current Behavior

It is opaque to me what can be null or not.

Context

One example is CallToolResult, where isError() or Content.priority() are wrapped primitive types that can be null. However, since they don't have an @Nullable annotation, those facts are not obvious to the dev and can cause bugs (most notably null pointer exceptions).

Bắt đầu bằng việc xem xét các API Java SDK công khai liên quan đến CallToolResult.isError() và Content.priority(), những API được issue xác định là nullable mặc dù sử dụng các kiểu nguyên thủy được bao bọc. Xác định những thuộc tính và phương thức công khai nào có thể trả về null, sau đó xác minh rằng tính nullable của chúng được thể hiện rõ ràng thông qua các annotation để bên gọi có thể nhận biết các giá trị nullable.