org.noear.solon.ai.mcp.client

类 McpSkillClient

java.lang.Object

org.noear.solon.ai.mcp.client.McpSkillClient

所有已实现的接口:

Skill

@Preview(value="3.9.0")
public class McpSkillClient
extends java.lang.Object
implements Skill

MCP 客户端技能代理

职责：作为 MCP 客户端，将远程 MCP 服务的能力（工具、资源、指令）封装为本地 Skill 接口。 特点：支持跨进程的能力调用，并通过 Prompt 上下文实现远程准入检查与动态指令获取。

从以下版本开始:

3.9.0

字段概要

字段

限定符和类型	字段和说明
protected McpClientProvider	clientProvider MCP 客户端提供者，负责底层的通信协议（如 Stdio, SSE）
protected SkillMetadata	metadata 缓存的技能元信息

构造器概要

构造器

构造器和说明
McpSkillClient(McpClientProvider clientProvider)

方法概要

限定符和类型	方法和说明
java.lang.String	description() 获取技能描述
java.lang.String	getInstruction(Prompt prompt) 动态指令获取：从远程服务端获取针对当前上下文优化后的 System Message 指令
java.util.Collection<FunctionTool>	getTools(Prompt prompt) 动态工具注入：获取该技能挂载的所有功能工具
protected java.util.stream.Stream<FunctionTool>	getToolsStream() 获取远程导出的工具流 过滤策略：自动剔除标记为 "hide" 的管理类工具（即元数据同步工具），仅保留业务工具
boolean	isSupported(Prompt prompt) 跨进程准入检查：请求远程服务端判断当前 Prompt 环境是否允许激活该技能
SkillMetadata	metadata() 获取技能元信息
java.lang.String	name() 获取技能名称（默认类名）
void	onAttach(Prompt prompt) 挂载钩子：技能被激活时触发 可用于初始化会话状态、审计日志记录或上下文预处理

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

clientProvider

protected final McpClientProvider clientProvider

MCP 客户端提供者，负责底层的通信协议（如 Stdio, SSE）

metadata

protected SkillMetadata metadata

缓存的技能元信息

构造器详细资料

McpSkillClient

public McpSkillClient(McpClientProvider clientProvider)

方法详细资料

name

public java.lang.String name()

从接口复制的说明: Skill

获取技能名称（默认类名）

指定者:

name 在接口中 Skill

description

public java.lang.String description()

从接口复制的说明: Skill

获取技能描述

指定者:

description 在接口中 Skill

metadata

public SkillMetadata metadata()

从接口复制的说明: Skill

获取技能元信息

指定者:

metadata 在接口中 Skill

isSupported

public boolean isSupported(Prompt prompt)

跨进程准入检查：请求远程服务端判断当前 Prompt 环境是否允许激活该技能

指定者:

isSupported 在接口中 Skill

参数:

prompt - 当前提示词上下文

返回:

true 表示激活并挂载该技能

onAttach

public void onAttach(Prompt prompt)

从接口复制的说明: Skill

挂载钩子：技能被激活时触发 可用于初始化会话状态、审计日志记录或上下文预处理

指定者:

onAttach 在接口中 Skill

getInstruction

public java.lang.String getInstruction(Prompt prompt)

动态指令获取：从远程服务端获取针对当前上下文优化后的 System Message 指令

指定者:

getInstruction 在接口中 Skill

getToolsStream

protected java.util.stream.Stream<FunctionTool> getToolsStream()

获取远程导出的工具流

过滤策略：自动剔除标记为 "hide" 的管理类工具（即元数据同步工具），仅保留业务工具

getTools

public java.util.Collection<FunctionTool> getTools(Prompt prompt)

从接口复制的说明: Skill

动态工具注入：获取该技能挂载的所有功能工具

指定者:

getTools 在接口中 Skill