
Hugging Face MCP
Подключает агента к Hugging Face Hub: искать модели, датасеты и Spaces, читать карточки, статьи и документацию, смотреть строки датасета и запускать Gradio-приложения из Spaces.
Сервер на стороне Hugging Face: ставить ничего не нужно, вход через OAuth по адресу с ?login или по токену в заголовке.
Как подключить
Что сделать до подключения
Аккаунт Hugging Face
В Claude Desktop и claude.ai сервер добавляется как коннектор Hugging Face в claude.ai/settings/connectors
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.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.hugging-face]
url = "https://huggingface.co/mcp?login"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"hugging-face": {
"url": "https://huggingface.co/mcp?login"
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"hugging-face": {
"type": "http",
"url": "https://huggingface.co/mcp?login"
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"hugging-face": {
"httpUrl": "https://huggingface.co/mcp?login"
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"hugging-face": {
"httpUrl": "https://huggingface.co/mcp?login"
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"hugging-face": {
"type": "remote",
"url": "https://huggingface.co/mcp?login"
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://huggingface.co/mcp?loginПроверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"hugging-face": {
"url": "https://huggingface.co/mcp?login"
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
hub_repo_searchищет модели, датасеты и Spaceshub_repo_detailsпоказывает карточку и файлы репозиторияhf_fsоткрывает Hub, статьи и документациюdynamic_spaceнаходит и запускает приложения Spacescreate_repoсоздаёт или копирует репозиторийhf_jobsзапускает скрипт на CPU или GPUhf_sandboxсоздаёт песочницу Hugging Facehf_sandbox_execвыполняет команду в песочницеhf_sandbox_fsчитает и пишет файлы песочницыТот же сервер на вашем компьютере через npx или Docker, токен передаётся переменной окружения.
Как подключить
Что сделать до подключения
npm с командой npx; вместо него подойдёт образ Docker ghcr.io/evalstate/hf-mcp-server с TRANSPORT=stdio
HF_TOKENтокен Hugging Face; в режиме stdio сервер берёт DEFAULT_HF_TOKEN, а если его нет — HF_TOKEN
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'HF_TOKEN=<токен Hugging Face>' --transport stdio hf-mcp-server \
-- npx @llmindset/hf-mcp-serverПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.hf-mcp-server]
command = "npx"
args = ["@llmindset/hf-mcp-server"]
[mcp_servers.hf-mcp-server.env]
HF_TOKEN = "<токен Hugging Face>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"hf-mcp-server": {
"command": "npx",
"args": ["@llmindset/hf-mcp-server"],
"env": {
"HF_TOKEN": "<токен Hugging Face>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"hf-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["@llmindset/hf-mcp-server"],
"env": {
"HF_TOKEN": "<токен Hugging Face>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"hf-mcp-server": {
"command": "npx",
"args": ["@llmindset/hf-mcp-server"],
"env": {
"HF_TOKEN": "<токен Hugging Face>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"hf-mcp-server": {
"command": "npx",
"args": ["@llmindset/hf-mcp-server"],
"env": {
"HF_TOKEN": "<токен Hugging Face>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"hf-mcp-server": {
"type": "local",
"command": ["npx", "@llmindset/hf-mcp-server"],
"environment": {
"HF_TOKEN": "<токен Hugging Face>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"hf-mcp-server": {
"command": "npx",
"args": ["@llmindset/hf-mcp-server"],
"env": {
"HF_TOKEN": "<токен Hugging Face>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"hf-mcp-server": {
"command": "npx",
"args": ["@llmindset/hf-mcp-server"],
"env": {
"HF_TOKEN": "<токен Hugging Face>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
hub_repo_searchищет модели, датасеты и Spaceshub_repo_detailsпоказывает карточку и файлы репозиторияhf_fsоткрывает Hub, статьи и документациюdynamic_spaceнаходит и запускает приложения Spacescreate_repoсоздаёт или копирует репозиторийhf_jobsзапускает скрипт на CPU или GPUЧто попросить агента
Для каких задач
Ограничения
Создание репозиториев, Jobs, запуск Spaces и песочницы работают только после входа в аккаунт Hugging Face
Ответы Gradio-приложений приходят с картинками; убрать их можно только параметром ?no_image_content=true в адресе сервера
hub_repo_details принимает не больше 10 репозиториев за вызов
Какую реализацию выбрать
| Реализация | Кто делает | Звёзды | Запуск | Ключ | Инструменты | Обновлён |
|---|---|---|---|---|---|---|
| Hugging Face MCP Server (удалённый)разработчик сервиса | Hugging Face | 314 | HTTP | вход | 9 | 10 ноября 2026 |
| Hugging Face MCP Server (локальный)разработчик сервиса | Hugging Face | 314 | локально | токен | 6 | 10 ноября 2026 |