Hugging Face MCP Server

Сервер Hugging Face MCP (Model Context Protocol) подключает ваш совместимый с MCP ИИ-ассистент (например, Codex, Cursor, расширения для VS Code, Zed, ChatGPT или Claude Desktop) непосредственно к Hugging Face Hub. После подключения ваш ассистент может искать и изучать ресурсы Hub, а также использовать инструменты сообщества — всё это прямо из вашего редактора, чата или CLI.

Что вы можете сделать

• Поиск и изучение ресурсов Hub: модели, наборы данных, Spaces, статьи и другое.
• Ищите в документации Hugging Face с помощью запросов на естественном языке.
• Планирование и запуск задач, использование песочниц
• Запускайте инструменты сообщества через MCP-совместимые приложения Gradio, размещённые на Spaces.
• Возвращайте результаты в ваш ассистент вместе с метаданными, ссылками и контекстом.

Начало работы

1. Откройте настройки MCP, будучи вошедшим в систему.

2. Выберите клиент: выберите ваш MCP‑совместимый клиент (например, Cursor, VS Code, Zed, Claude Desktop). На странице отображаются инструкции, специфичные для клиента, и готовый к копированию фрагмент конфигурации.

3. Вставьте и перезапустите: скопируйте фрагмент в конфигурацию MCP вашего клиента, сохраните изменения и перезапустите/перезагрузите клиент. В списке подключённых MCP-серверов в вашем клиенте должен появиться пункт «Hugging Face» (или аналогичный).

Страница настроек генерирует точную конфигурацию, которую ожидает ваш клиент. Используйте её, а не создавайте конфигурацию вручную.

Использование сервера

После подключения попросите вашего ассистента использовать инструменты Hugging Face. Примеры запросов:

• «Поиск моделей Hugging Face для квантованных версий Qwen 3.6.»
• “Найдите Space, который может транскрибировать аудиофайлы.”
• «Показать наборы данных о временных рядах погоды.»
• Создайте изображение размером 1024 x 1024 с котом в стиле Ghibli.
• «Как использовать адаптеры LoRA с PEFT?» (использует семантический поиск по документации)
• «Найдите статьи о моделях «зрение-язык».»

Ваш ассистент будет навигировать по Hub с помощью инструментов, предоставленных MCP Server (включая выбранные вами Spaces, как показано в следующем разделе), и возвращать результаты (названия, владельцы, загрузки, ссылки и т. д.). После этого вы можете открыть ресурс на Hub или продолжить работу в том же чате.

Встроенные инструменты

Большинство задач на Hub можно эффективно выполнять с помощью встроенного инструмента hf_fs. Он позволяет вашему ассистенту эффективно навигировать по Hub, включая семантический поиск по Documents и Spaces.

Вы можете настроить дополнительные инструменты на странице настроек MCP.

Инструмент	Описание
Репозитории для вклада	Создайте и запишите файлы в созданные репозитории
Песочницы	Создание и использование Sandboxes: включает управление файлами Sandbox
Запуск и управление заданиями	Запускайте, отслеживайте и планируйте задачи на инфраструктуре Hugging Face.

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

Добавить инструменты сообщества (Spaces)

Вы можете расширить свою конфигурацию с помощью совместимых с MCP Gradio Spaces, созданных сообществом:

• Ознакомьтесь с Spaces с поддержкой MCP здесь.
• Добавьте соответствующий Space в ваши настройки MCP на Hugging Face здесь.

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

Смотрите наше специальное руководство по использованию Spaces в качестве MCP-серверов здесь.

Параметры Spaces

Ваши настройки MCP предлагают несколько вариантов для настройки работы Spaces:

Параметр	Описание
Динамические Spaces	Динамически вызывайте MCP Spaces во время выполнения. При включении этой функции ваш ассистент может обнаруживать и использовать совместимые с MCP Spaces на лету, без необходимости добавлять их вручную.
Удалить встроенные изображения	Удаляет встроенные изображения, сгенерированные в Gradio Spaces. Полезно, если ваш MCP-клиент имеет ограниченную поддержку изображений или если вы хотите получать ответы только в текстовом формате.

Подробнее

• Настройки и настройка клиента: https://huggingface.co/settings/mcp
• Объявление об изменениях: https://huggingface.co/changelog/hf-mcp-server
• Hugging Face MCP Server: https://huggingface.co/mcp
• Создайте собственный MCP Server с помощью Gradio Spaces: https://www.gradio.app/guides/building-mcp-server-with-gradio

Update on GitHub