Hugging Face MCP

huggingface/hf-mcp-server· Проверено 12.11.2026· 314на GitHub

Подключает агента к Hugging Face Hub: искать модели, датасеты и Spaces, читать карточки, статьи и документацию, смотреть строки датасета и запускать Gradio-приложения из Spaces.

2 реализации:

Сервер на стороне Hugging Face: ставить ничего не нужно, вход через OAuth по адресу с ?login или по токену в заголовке.

Как подключить

Что сделать до подключения

1

Аккаунт Hugging Face

2

В Claude Desktop и claude.ai сервер добавляется как коннектор Hugging Face в claude.ai/settings/connectors

3
Authorization

для клиентов без OAuth: адрес https://huggingface.co/mcp и заголовок Bearer <токен Hugging Face>

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http hugging-face https://huggingface.co/mcp?login

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

hub_repo_searchищет модели, датасеты и Spaces
hub_repo_detailsпоказывает карточку и файлы репозитория
hf_fsоткрывает Hub, статьи и документацию
dynamic_spaceнаходит и запускает приложения Spaces
create_repoсоздаёт или копирует репозиторий
hf_jobsзапускает скрипт на CPU или GPU
hf_sandboxсоздаёт песочницу Hugging Face
hf_sandbox_execвыполняет команду в песочнице
hf_sandbox_fsчитает и пишет файлы песочницы

Что попросить агента

«Найди модели для <задача> и отсортируй по скачиваниям»Агент вызовет hub_repo_search и даст ссылки на репозитории
«Какая лицензия и какие файлы у <author/model>?»Агент вызовет hub_repo_details
«Покажи структуру датасета <author/dataset> и пару строк»Агент вызовет hub_repo_details с операциями dataset_structure и dataset_preview
«Что сегодня в трендах среди статей на Hugging Face?»Агент откроет ежедневную подборку статей через hf_fs
«Озвучь этот текст через подходящий Space: <текст>»Агент найдёт приложение и вызовет его через dynamic_space

Для каких задач

Найти модели и датасеты по задаче и отсортировать по скачиваниям, лайкам или трендам
Показать лицензию, скачивания и файлы модели
Разобрать структуру датасета и показать строки для примера
Найти статьи, ежедневную подборку статей и страницы документации
Запустить Gradio-приложение из Spaces: озвучку, генерацию картинок или видео
Отправить скрипт на Python или контейнер Docker считаться на GPU через Jobs

Ограничения

!

Создание репозиториев, Jobs, запуск Spaces и песочницы работают только после входа в аккаунт Hugging Face

!

Ответы Gradio-приложений приходят с картинками; убрать их можно только параметром ?no_image_content=true в адресе сервера

!

hub_repo_details принимает не больше 10 репозиториев за вызов

Какую реализацию выбрать

РеализацияКто делаетЗвёздыЗапускКлючИнструментыОбновлён
Hugging Face MCP Server (удалённый)разработчик сервисаHugging Face314HTTPвход910 ноября 2026
Hugging Face MCP Server (локальный)разработчик сервисаHugging Face314локальнотокен610 ноября 2026

Частые вопросы

Как выбрать инструменты и Spaces?
После подключения откройте huggingface.co/settings/mcp: там включаются нужные инструменты и Spaces, которые агент увидит.
Как подключить сервер в Claude Code?
Выполните claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login, запустите claude и пройдите вход. Без OAuth добавьте -H "Authorization: Bearer <токен>" к адресу https://huggingface.co/mcp.
Как убрать картинки из ответов Gradio?
Допишите к адресу ?no_image_content=true: блоки ImageContent от Gradio-серверов перестанут приходить в ответах.
Что открывает параметр ?bouquet=openai?
Набор с файловой системой Hub, поиском, карточками и созданием репозиториев, запуском Spaces, Jobs и песочницами. Создание, Jobs, Spaces и песочницы требуют входа.
Работает ли сервер из России?
Удалённый сервер работает на стороне Hugging Face, для входа нужен аккаунт Hugging Face; локальный вариант запускается на вашем компьютере.

Похожие серверы