René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`McpSchema.Tool` requires the annotations attribute.","articleBody":"**Expected Behavior**\n\nThe `McpSchema.Tool` class should support the annotations attribute.\n\n**Current Behavior**\nThe `McpSchema.Tool` class currently only has the `name`, `description`, and `inputSchema` properties.\n\n\n**Context**\n\nI believe we need to support the `annotations` property in the `McpSchema.Tool` class for the following reasons:\n\n1. **It is part of the MCP specification**: As stated in the MCP specification (https://modelcontextprotocol.io/docs/concepts/tools#tool-definition-structure\n), this property is very useful as it allows the MCP server to provide additional descriptions about a tool’s behavior to the client.\n\n2. **Better integration with the Spring ecosystem (e.g., Spring AI)**: Supporting this property would enable better interoperability with frameworks like Spring AI. In Spring AI, there is a `returnDirect` attribute for tools(https://docs.spring.io/spring-ai/reference/1.1-SNAPSHOT/api/tools.html#_return_direct), which indicates that the result of the tool call should be returned directly to the user instead of being sent back to the model. However, since `McpSchema.Tool` currently lacks a way to carry this attribute, `returnDirect` becomes ineffective in MCP scenarios(for details on this point, please refer to: https://github.com/spring-projects/spring-ai/issues/3481#issuecomment-2955636384 ). I believe it's a good approach to pass this value through `annotations`.\n\n3. **Support and extension in other language SDKs**: The `annotations` property is already supported in MCP SDKs for languages such as `Python` and `Swift`, and each has extended it in their own way.\n","author":{"url":"https://github.com/sunyuhan1998","@type":"Person","name":"sunyuhan1998"},"datePublished":"2025-06-13T11:52:57.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/312/java-sdk/issues/312"}