GH-3805: Add title attribute support to MCP @Tool annotation

[codeboyzhou]

As the title described, this PR was created to solve issue #3805, please refer to the issue for more details.

[sunyuhan1998]

Actually, @Tool was not originally designed specifically for MCP's tools. It is not an equivalent to McpSchema.Tool. The development of MCP has been too fast. I've noticed that we are trying to add more and more features to @Tool, attempting to bring it closer in functionality to McpSchema.Tool. I believe this is because we initially supported using @Tool to define tools on the MCP server side.

Perhaps we need a set of annotations such as @McpTool, @McpPrompt, and @McpResource, similar to what this project: https://github.com/spring-ai-community/mcp-annotations does. However, at this point, the project doesn't seem mature enough to be merged into Spring AI yet.

[sunyuhan1998]

please sign off your commit to comply with the DCO

[codeboyzhou]

Actually, @Tool was not originally designed specifically for MCP's tools. It is not an equivalent to McpSchema.Tool. The development of MCP has been too fast. I've noticed that we are trying to add more and more features to @Tool, attempting to bring it closer in functionality to McpSchema.Tool. I believe this is because we initially supported using @Tool to define tools on the MCP server side.

Perhaps we need a set of annotations such as @McpTool, @McpPrompt, and @McpResource, similar to what this project: https://github.com/spring-ai-community/mcp-annotations does. However, at this point, the project doesn't seem mature enough to be merged into Spring AI yet.

Oh I see, thanks for your patient explanation. That was also my confusion why there is no @Prompt and @Resource, you tell me the answer now.

By the way, for the annotations @McpTool, @McpPrompt, and @McpResource, I am a little familiar, but it's not due to spring-ai-community, actually I didn't know about this community, so I created a personal repository to do the things same like mcp-annotations months ago, just want to make my MCP exploration journey easier, because the native MCP Java SDK is a bit cumbersome to use, but after all, it's underlying implementation. I will learn about the project spring-ai-community/mcp-annotations you mentioned, thanks again.

[codeboyzhou]

please sign off your commit to comply with the DCO

Thank you for the reminder. It's already done.