hugging-face-mcp - Hugging Face, поиск моделей для агента

Что понадобится: аккаунт на Hugging Face (бесплатная регистрация на их сайте).

Когда звать

• Когда нужно подобрать модель или датасет под задачу и агенту надо искать на Hugging Face самому, а не пересказывать устаревшее.
• Когда на Hugging Face есть готовое приложение (Space) для нужной задачи, например распознавание или генерация, и агент должен вызывать его как инструмент.

Что это

Hugging Face - большой каталог открытых моделей, наборов данных и небольших приложений на Gradio (они называются Spaces). Агент может знать о нём по обучению, но каталог меняется каждый день. Этот сервер даёт агенту прямой доступ к актуальным данным: он сам ищет и читает, а не вспоминает.

По README это официальный сервер Hugging Face, который соединяет модель-помощника с Hub и тысячами приложений на Gradio.

Что агент с ним делает

Инструменты зависят от набора, который ты включишь на странице настроек huggingface.co/settings/mcp. По README это:

• ищет по Hub (в README среди инструментов упомянут поиск по репозиториям) и достаёт описания найденного;
• вызывает выбранные тобой Spaces как отдельные инструменты, например приложение для распознавания речи или изображений.

Есть и режимы с «записью»: создание репозиториев, запуск задач, динамические Spaces. README отмечает, что им нужен вход в аккаунт. Включай их, когда это правда нужно.

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

В Claude Code (команда из README):

claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login

Затем запусти claude и пройди вход, как попросит программа. Если хочется токеном, README показывает вариант с заголовком Authorization: Bearer <твой токен> и адресом без ?login.

В Codex команды у автора нет. Рабочий вариант собран из справки Codex:

export HF_TOKEN=<твой токен Hugging Face>
codex mcp add hf-mcp-server --url https://huggingface.co/mcp --bearer-token-env-var HF_TOKEN

Мы эту строку на живом сервере не проверяли. Токен можно создать в своём аккаунте Hugging Face; никому его не показывай.

Проверка: спроси агента «найди на Hugging Face модели для распознавания речи на русском и покажи лицензии». Он должен вернуть список с описаниями и ссылками на Hub.

На что смотреть

Первое: токен. Он даёт доступ от твоего имени. Выдавай токену только те права, которые нужны для задачи.

Второе: чужие приложения. Spaces - это программы сторонних авторов. Когда агент вызывает приложение, твой запрос уходит в него, а что приложение делает с данными, решает его автор. Не отправляй туда ничего личного и рабочего.

Третье: версия. Репозиторий активный, выпуски идут часто (на проверку был 0.4.31), поэтому перед установкой открой первоисточник и сверь команды.

Мы сверили описание с README на 22 октября 2026 года. Сам сервер мы не запускали. Если пока нужен просто поиск по сети, посмотри в каталоге Tavily; как работают MCP-серверы вообще - в статье про MCP в Claude Code.