Hugging Face MCP: Документация

Обновлено: 25 июля 2026 г.

Подключение

Remote: https://huggingface.co/mcp — Streamable HTTP (SSE) или stateless JSON-RPC (используется по умолчанию в Docker-образе).
Локально: npx @huggingface/hf-mcp-server или Docker-образ (stdio).
Auth: заголовок Authorization: Bearer <HF_TOKEN> (переменные HF_TOKEN/DEFAULT_HF_TOKEN для stdio) либо OAuth — агент вызывает встроенный инструмент Authenticate и проходит вход в браузере.
Готовые коннекторы: Claude Desktop/claude.ai, Claude Code (HTTP + токен), Gemini CLI, VS Code, Cursor.

Инструменты

Наборы включаются и выключаются по отдельности (веб-дашборд или переменные окружения):

Поиск моделей, датасетов, Spaces и научных статей Hub по названию и описанию.
hf_fs — семантический поиск по документации Hugging Face.
Gradio-инструменты — Spaces с включённым MCP-сервером становятся вызываемыми инструментами агента напрямую.
Authenticate — запуск OAuth-входа прямо из диалога.
Jobs и Sandboxes — запуск и мониторинг тяжёлых вычислительных задач и изолированных песочниц.
Прокси-инструменты — подключение сторонних MCP-серверов через CSV-конфигурацию.

Сценарий для агента

«Найди модели для генерации изображений с лицензией Apache-2.0», «покажи датасеты по классификации текста на русском», «запусти Gradio-приложение X с этим промптом», «объясни, как настроить LoRA по документации Hugging Face».

Тарифы

MCP-сервер бесплатный и открытый (266★); часть операций (запуск моделей, Jobs) расходует платные Inference-кредиты или собственные вычислительные ресурсы аккаунта Hugging Face.