feat(mcp):support higress tool search

[qingTang0305]

Change-Id: Ia1745a9f18df02cea558774c9ecb994111d59931

AgentScope-Java Version

[The version of AgentScope-Java you are working on, e.g. 1.0.3, check your pom.xml dependency version or run mvn dependency:tree | grep agentscope-parent:pom(only mac/linux)]

Description

feat(mcp):#312

Checklist

Please check the following items before code is ready to be reviewed.

• Code has been formatted with mvn spotless:apply
• All tests are passing (mvn test)
• Javadoc comments are complete and follow project conventions
• Related documentation has been updated (e.g. links, examples, etc.)
• Code is ready for review

[codecov]

Codecov Report

❌ Patch coverage is 86.36364% with 33 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...pe/extensions/higress/HigressMcpClientBuilder.java	63.63%	26 Missing and 2 partials ⚠️
...pe/extensions/higress/HigressToolSearchResult.java	93.22%	0 Missing and 4 partials ⚠️
...pe/extensions/higress/HigressMcpClientWrapper.java	98.92%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

[Copilot]

Pull request overview

This PR adds Higress AI Gateway integration to AgentScope-Java, enabling unified access to MCP tools through the Higress gateway with semantic search capabilities for intelligent tool selection.

Key Changes:

• New agentscope-extensions-higress module with builder pattern for client configuration
• Semantic tool search via the x_higress_tool_search tool to automatically select relevant tools
• Support for both SSE and StreamableHTTP transport types

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
docs/zh/task/mcp.md	Added Chinese documentation for Higress integration with usage examples
docs/en/task/mcp.md	Added English documentation for Higress integration with usage examples
agentscope-extensions/pom.xml	Added Higress module to extensions parent POM
agentscope-extensions/agentscope-extensions-higress/pom.xml	New module POM with dependencies on agentscope-core and MCP SDK
HigressMcpClientBuilder.java	Builder class for configuring Higress MCP clients with fluent API
HigressMcpClientWrapper.java	Wrapper extending McpClientWrapper to handle Higress-specific operations
HigressToolSearchResult.java	Result parser for x_higress_tool_search responses with structured content support
HigressToolkit.java	Extended Toolkit class that caches registered Higress clients
HigressMcpClientBuilderTest.java	Comprehensive unit tests for builder validation and configuration
HigressMcpClientWrapperTest.java	Unit tests for wrapper functionality including tool search and caching
HigressToolSearchResultTest.java	Unit tests for parsing various tool search result formats
HigressToolkitTest.java	Unit tests for toolkit registration and client caching
HigressToolExample.java	Example demonstrating Higress integration with ReActAgent
agentscope-examples/quickstart/pom.xml	Added Higress dependency to quickstart examples
agentscope-distribution/agentscope-bom/pom.xml	Added Higress extension to BOM for version management

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.