McpToolServerConfigurationService class
负责发现和规范化 MCP（模型上下文协议）工具服务器以及生成 Claude SDK 易耗的配置对象的服务。
构造函数
| Mcp |
构造 McpToolServerConfigurationService。 |
方法
| get |
连接到 MCP 服务器并返回名称以服务器名称为前缀的工具。 如果服务器 URL 缺失或客户端无法列出工具，则引发。 |
| list |
返回给定代理的 MCP 服务器定义。 在开发（NODE_ENV=Development）中，这将读取本地 ToolingManifest.json;否则，它会查询远程工具网关。 |
| list |
返回给定代理的 MCP 服务器定义。 在开发（NODE_ENV=Development）中，这将读取本地 ToolingManifest.json;否则，它会查询远程工具网关。 |
| list |
返回给定代理的 MCP 服务器定义。 在开发（NODE_ENV=Development）中，这将读取本地 ToolingManifest.json;否则，它会查询远程工具网关。 此重载会自动解析 TurnContext 中的 agenticAppId，如果未提供身份验证令牌，则生成身份验证令牌。 |
| send |
将聊天历史记录发送到 MCP 平台进行实时威胁防护。 |
| send |
将聊天历史记录发送到 MCP 平台进行实时威胁防护。 |
构造函数详细信息
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
构造 McpToolServerConfigurationService。
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)参数
- configProvider
可选配置提供程序。 如果未指定，则默认为 defaultToolingConfigurationProvider。
方法详细信息
getMcpClientTools(string, MCPServerConfig)
连接到 MCP 服务器并返回名称以服务器名称为前缀的工具。 如果服务器 URL 缺失或客户端无法列出工具，则引发。
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>参数
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
返回
Promise<McpClientTool[]>
listToolServers(string, string)
警告
现已弃用此 API。
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
返回给定代理的 MCP 服务器定义。 在开发（NODE_ENV=Development）中，这将读取本地 ToolingManifest.json;否则，它会查询远程工具网关。
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>参数
- agenticAppId
-
string
要为其发现服务器的代理应用 ID。
- authToken
-
string
查询远程工具网关时使用的持有者令牌。
返回
Promise<MCPServerConfig[]>
解析为规范化 MCP 服务器配置对象的数组的承诺。
listToolServers(string, string, ToolOptions)
警告
现已弃用此 API。
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
返回给定代理的 MCP 服务器定义。 在开发（NODE_ENV=Development）中，这将读取本地 ToolingManifest.json;否则，它会查询远程工具网关。
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>参数
- agenticAppId
-
string
要为其发现服务器的代理应用 ID。
- authToken
-
string
查询远程工具网关时使用的持有者令牌。
- options
- ToolOptions
调用网关时的可选工具选项。
返回
Promise<MCPServerConfig[]>
解析为规范化 MCP 服务器配置对象的数组的承诺。
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
返回给定代理的 MCP 服务器定义。 在开发（NODE_ENV=Development）中，这将读取本地 ToolingManifest.json;否则，它会查询远程工具网关。 此重载会自动解析 TurnContext 中的 agenticAppId，如果未提供身份验证令牌，则生成身份验证令牌。
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>参数
- turnContext
- TurnContext
当前请求的 TurnContext。
- authorization
- Authorization
令牌交换的授权对象。
- authHandlerName
-
string
用于令牌交换的身份验证处理程序的名称。
- authToken
-
string
可选持有者令牌。 如果未提供，将通过令牌交换自动生成。
- options
- ToolOptions
调用网关时的可选工具选项。
返回
Promise<MCPServerConfig[]>
解析为规范化 MCP 服务器配置对象的数组的承诺。
sendChatHistory(TurnContext, ChatHistoryMessage[])
将聊天历史记录发送到 MCP 平台进行实时威胁防护。
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>参数
- turnContext
- TurnContext
包含聊天信息的轮次上下文。
- chatHistoryMessages
要发送的聊天历史记录消息。
返回
Promise<OperationResult>
解析为指示成功或失败的 OperationResult 的 Promise。
注解
HTTP 异常（网络错误、超时）被捕获并记录，但不会重新引发。 相反，该方法返回一个 OperationResult，指示操作是成功还是失败。 如果不需要错误详细信息，调用方可以选择检查结果以处理错误或忽略它。
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
将聊天历史记录发送到 MCP 平台进行实时威胁防护。
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>参数
- turnContext
- TurnContext
包含聊天信息的轮次上下文。
- chatHistoryMessages
要发送的聊天历史记录消息。
- options
- ToolOptions
用于发送聊天历史记录的可选工具选项。
返回
Promise<OperationResult>
解析为指示成功或失败的 OperationResult 的 Promise。
注解
HTTP 异常（网络错误、超时）被捕获并记录，但不会重新引发。 相反，该方法返回一个 OperationResult，指示操作是成功还是失败。 如果不需要错误详细信息，调用方可以选择检查结果以处理错误或忽略它。