Hugging Face MCP Server
Hugging Face Official MCP Server
Официальный MCP-сервер Hugging Face: поиск по Hub и подключение приложений Gradio из Spaces как инструментов агента
Установка
claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?loginЗатем запустите claude и пройдите авторизацию.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к Hugging Face Hub: поиск и сведения о репозиториях моделей, датасетов и Spaces, работа с файлами Hub. Кроме встроенных инструментов агент может вызывать приложения Gradio из Spaces, которые пользователь выбирает в настройках на huggingface.co/settings/mcp. С авторизацией доступны также Jobs, динамические Spaces и песочница. Hugging Face держит размещенную версию сервера, есть и локальный запуск через npx или Docker.
Для кого. Для ML-инженеров и разработчиков, которые ищут модели и датасеты или хотят вызывать AI-приложения из Spaces.
Подходит, если
- Нужно подобрать модель или датасет под задачу, не выходя из агента
- Нужно вызвать приложение Gradio, например генерацию картинок, как инструмент
- Нужно посмотреть файлы и описание репозитория на Hub
Не подходит, если
- Нет аккаунта Hugging Face, а нужны Jobs или приватные репозитории
- Нужен локальный инференс моделей без облака
Пример запроса к агенту
Найди на Hugging Face небольшую модель для распознавания русской речи с открытой лицензиейОграничения
Для части инструментов нужен вход через OAuth или токен Hugging Face. Spaces работают на стороне Hugging Face и могут спать или падать, вызовы тяжелых приложений расходуют квоты аккаунта. Доступ к Hugging Face из России без VPN работает нестабильно.
Как отключить. Выполните claude mcp remove hf-mcp-server или удалите коннектор Hugging Face в настройках клиента, затем отзовите токен на huggingface.co.
MCP
- Транспорт
- http, stdio
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| HF_TOKEN секрет | Токен Hugging Face для локального STDIO-режима |
| DEFAULT_HF_TOKEN секрет | Токен по умолчанию для локального STDIO, приоритетнее HF_TOKEN |
| TRANSPORT | stdio или streamableHttpJson |
| DISABLE_TOOLS | Инструменты, которые нужно скрыть и запретить |
Проверка безопасности
- Вызывает сторонние приложения из Spaces
- Использует токен Hugging Face и может запускать Jobs
Коротко о README
README начинается с установки размещенного сервера в Claude Desktop, Claude Code, Gemini CLI, VS Code и Cursor с OAuth или токеном. Далее описаны пакеты репозитория, транспорты STDIO и Streamable HTTP, локальный запуск через npx и Docker. Большая часть посвящена переменным окружения, прокси-инструментам из CSV, раздаче скиллов и мониторингу Spaces для тех, кто разворачивает сервер сам.
Частые вопросы
Как выбрать, какие Spaces доступны агенту?
В настройках аккаунта на huggingface.co/settings/mcp. Набор инструментов подтягивается для каждого запроса отдельно.
Можно ли убрать картинки из ответов Gradio?
Да, добавьте к адресу сервера параметр ?no_image_content=true.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Открытая библиотека промптов с плагином Claude Code, MCP-сервером и CLI: поиск, получение и улучшение промптов и скиллов из агента