McpToolServerConfigurationService class

Служба, отвечающая за обнаружение и нормализацию серверов инструментов MCP (протокол контекста модели) и создание объектов конфигурации, используемых пакетом SDK claude.

Конструкторы

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Создайте Службу McpToolServerConfigurationService.

Методы

getMcpClientTools(string, MCPServerConfig)

Подключитесь к серверу MCP и возвращайте средства с именами, префиксными именем сервера. Вызывает, если ОТСУТСТВУЕТ URL-адрес сервера, или клиент не может перечислить средства.

listToolServers(string, string)

Возвращает определения сервера MCP для данного агента. При разработке (NODE_ENV=Разработка) это считывает локальные ToolingManifest.json; в противном случае он запрашивает шлюз удаленных инструментов.

listToolServers(string, string, ToolOptions)

Возвращает определения сервера MCP для данного агента. При разработке (NODE_ENV=Разработка) это считывает локальные ToolingManifest.json; в противном случае он запрашивает шлюз удаленных инструментов.

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

Возвращает определения сервера MCP для данного агента. При разработке (NODE_ENV=Разработка) это считывает локальные ToolingManifest.json; в противном случае он запрашивает шлюз удаленных инструментов. Эта перегрузка автоматически разрешает агентicAppId из TurnContext и создает маркер проверки подлинности, если он не указан.

sendChatHistory(TurnContext, ChatHistoryMessage[])

Отправляет журнал чата на платформу MCP для защиты от угроз в режиме реального времени.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Отправляет журнал чата на платформу MCP для защиты от угроз в режиме реального времени.

Сведения о конструкторе

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

Создайте Службу McpToolServerConfigurationService.

new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)

Параметры

configProvider

IConfigurationProvider<ToolingConfiguration>

Необязательный поставщик конфигурации. По умолчанию значение 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=Разработка) это считывает локальные ToolingManifest.json; в противном случае он запрашивает шлюз удаленных инструментов.

function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>

Параметры

agenticAppId

string

Идентификатор агента, для которого нужно обнаружить серверы.

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=Разработка) это считывает локальные ToolingManifest.json; в противном случае он запрашивает шлюз удаленных инструментов.

function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>

Параметры

agenticAppId

string

Идентификатор агента, для которого нужно обнаружить серверы.

authToken

string

Маркер носителя, используемый при запросе шлюза удаленных инструментов.

options
ToolOptions

Необязательные параметры инструментов при вызове шлюза.

Возвращаемое значение

Promise<MCPServerConfig[]>

Обещание разрешения массива нормализованных объектов конфигурации сервера MCP.

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

Возвращает определения сервера MCP для данного агента. При разработке (NODE_ENV=Разработка) это считывает локальные ToolingManifest.json; в противном случае он запрашивает шлюз удаленных инструментов. Эта перегрузка автоматически разрешает агентicAppId из TurnContext и создает маркер проверки подлинности, если он не указан.

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

ChatHistoryMessage[]

Сообщения журнала чата для отправки.

Возвращаемое значение

Promise<OperationResult>

Обещание, разрешающее операцию OperationResult, указывающую на успех или сбой.

Комментарии

Исключения HTTP (сетевые ошибки, тайм-ауты) перехватываются и регистрируются, но не регистрируются повторно. Вместо этого метод возвращает operationResult, указывающий, выполнена ли операция успешно или не выполнена. Вызывающие могут проверить результат обработки ошибок или игнорировать его, если сведения об ошибке не нужны.

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

Отправляет журнал чата на платформу MCP для защиты от угроз в режиме реального времени.

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>

Параметры

turnContext
TurnContext

Контекст поворота, содержащий сведения о беседе.

chatHistoryMessages

ChatHistoryMessage[]

Сообщения журнала чата для отправки.

options
ToolOptions

Необязательные параметры инструментов для отправки журнала чата.

Возвращаемое значение

Promise<OperationResult>

Обещание, разрешающее операцию OperationResult, указывающую на успех или сбой.

Комментарии

Исключения HTTP (сетевые ошибки, тайм-ауты) перехватываются и регистрируются, но не регистрируются повторно. Вместо этого метод возвращает operationResult, указывающий, выполнена ли операция успешно или не выполнена. Вызывающие могут проверить результат обработки ошибок или игнорировать его, если сведения об ошибке не нужны.