client

@mcp-z/client — это программная клиентская библиотека MCP для Node.js (требуется Node.js >= 22). Она поддерживает подключение к нескольким MCP-серверам в рамках одного процесса, запуск MCP-инструментов из скриптов и написание интеграционных тестов для MCP-серверов. Поддерживаемые транспорты включают stdio и HTTP. HTTP-серверы могут быть опционально запущены через расширение блока `start` с использованием опции `dialects: ['start']`. Библиотека также поддерживает OAuth через Dynamic Client Registration (DCR), если HTTP-сервер это поддерживает, что позволяет передавать хранилище токенов (например, Keyv) через `dcrAuthenticator`. Основной API сосредоточен вокруг реестра серверов, создаваемого с помощью `createServerRegistry(config, options?)`. Реестр предоставляет методы для подключения к именованным серверам (`registry.connect`), поиска возможностей по всем серверам (`registry.searchCapabilities`) и закрытия всех соединений (`registry.close`). Управляемые клиенты предоставляют методы для вызова инструментов (`callTool`), получения промптов (`getPrompt`), чтения ресурсов (`readResource`), а также перечисления инструментов, ресурсов или промптов. Также доступны варианты с необработанными ответами SDK (`callToolRaw`, `getPromptRaw`, `readResourceRaw`). Обертки ответов предоставляют вспомогательные методы: `json()` для парсинга структурированного контента, `text()` для первого текстового результата и `raw()` для необработанного ответа MCP. Опции реестра включают `cwd` для рабочей директории запускаемого процесса, `env` для базовых переменных окружения и `dialects` для управления типами запускаемых серверов (stdio-серверы, HTTP-блоки start или и то, и другое). Документация API доступна на сайте документации проекта.