工具（Tool）使用指南

AJ MCP 的工具系统提供了一种结构化方式，用于定义可被客户端发现和调用的函数。每个工具都有名称、描述和一个定义其输入参数的 JSON Schema。该工具系统旨在让大语言模型（LLM）能够轻松理解可用工具及其用法。

列出工具

列出所有可用工具：

List<ToolItem> tools = mcpClient.listTools();
assertEquals(7, tools.size());

listTools() 请求第一页（默认页），不会自动跟随 nextCursor。如需获取其他页，请调用 listTools(int pageNo)。

List<ToolItem> tools = mcpClient.listTools(1);
assertEquals(3, tools.size());

调用工具

调用某个工具：

String toolExecutionResultString = mcpClient.callTool("echoString", "{\"input\": \"hi\"}");
assertEquals("hi", toolExecutionResultString);

当前 callTool() 便捷接口返回由文本内容拼接而成的 String，不会通过该方法暴露图片内容。工具业务错误会转换为错误消息字符串；传输错误和超时则遵循客户端的异常与超时处理逻辑。

通知处理

当前 Java 客户端尚未公开进度通知或列表变更通知的回调注册 API。已支持的行为请参阅通知处理。