@huggingface/mcp-client

Клиент для протокола контекста модели (MCP).

Этот пакет предоставляет реализацию клиента для взаимодействия с MCP-серверами, построенную на основе нашего @huggingface/inference, InferenceClient.

В него включён пример CLI-агента smol, который может использовать инструменты MCP.

Установка

Этот пакет входит в состав монорепозитория Hugging Face JS. Чтобы установить зависимости для всех пакетов, выполните команду из корня репозитория:

pnpm install

Использование (CLI Agent)

Пакет включает в себя агента командной строки (CLI), демонстрирующего, как использовать MCP-клиент.

Предварительные требования

• Hugging Face API Token: Вам нужен токен Hugging Face API с соответствующими правами доступа. Задайте его в качестве переменной окружения:
  Скопировано

  export HF_TOKEN="hf_..."

Запуск агента

Перейдите в каталог пакета и запустите скрипт агента:

cd packages/mcp-client
pnpm agent

В качестве альтернативы выполните команду из корня монорепозитория:

pnpm --filter @huggingface/mcp-client agent

Агент загрузит доступные MCP-инструменты (по умолчанию подключаясь к серверу файловой системы для вашего рабочего стола и к серверу Playwright) и запросит ввод (>).

Конфигурация (переменные окружения)

• HF_TOKEN (необязательно): ваш API-токен Hugging Face. Требуется, если вы используете Inference Provider на HF.
• MODEL_ID (необязательно): идентификатор модели, используемый для инференса агента. По умолчанию — Qwen/Qwen2.5-72B-Instruct.
• PROVIDER (необязательный): провайдер инференса. По умолчанию — together. Список доступных провайдеров см. в @huggingface/inference.
• ENDPOINT_URL или BASE_URL (необязательно): пользовательский базовый URL (например, локальный) для вызова.

Пример с пользовательской моделью:

export HF_TOKEN="hf_..."
export MODEL_ID="Qwen/Qwen2.5-72B-Instruct"
pnpm agent

Разработка

Общие задачи разработки можно выполнять с помощью скриптов pnpm:

• pnpm build: сборка пакета.
• pnpm lint: проверка и исправление стиля кода.
• pnpm format: Форматирование кода с помощью Prettier.
• pnpm test: запуск тестов с помощью Vitest.
• pnpm check: проверка типов кода с помощью TypeScript.

Лицензия

MIT