AI Tool Atlas
Servidor MCP Oficial

Hugging Face MCP Server

Servidor MCP oficial de Hugging Face: conecta un LLM con el Hub y Gradio Spaces.

Autor
Hugging Face
Funciona con
Any MCP client, Claude Code, Cursor, Gemini CLI
Licencia
MIT
Documentado
Oct 2, 2026
Repositorio ↗ Docs oficiales ↗ Registro ↗

Qué es Hugging Face MCP Server

El servidor MCP oficial de Hugging Face conecta tu LLM con el Hugging Face Hub y miles de aplicaciones de IA de Gradio. Está disponible como endpoint alojado en https://huggingface.co/mcp y también puede ejecutarse en local por STDIO o Streamable HTTP sin estado mediante npx o Docker. Las herramientas y los Spaces se configuran en huggingface.co/settings/mcp.

Qué hace

Cómo se integra Hugging Face MCP Server: qué agentes lo ejecutan y qué añadeSE EJECUTA ENTu agenteClaude CodeGemini CLICursorAny MCP client4 hosts documentadosMCP SERVER · OFICIALHugging Face MCP ServerConecta el agente con herramienta…5 pasos de instalación2 notas de permisoslicencia: MITLO QUE AÑADEQué haceExpone la API del Hugging Face Hu…Se conecta a Gradio Spaces como h…Ofrece la opción bouquet=openai c…Se ejecuta por STDIO o Streamable…agente → extensión → nueva capacidad · desde el repositorio o la documentación oficial
Dónde se ejecuta Hugging Face MCP Server y qué añade, según su documentación
  • Expone la API del Hugging Face Hub y sus endpoints de búsqueda como herramientas MCP
  • Se conecta a Gradio Spaces como herramientas
  • Ofrece la opción bouquet=openai con herramientas de sistema de archivos del Hub, búsqueda, detalle y creación de repos, Space dinámico, Jobs y sandbox
  • Se ejecuta por STDIO o Streamable HTTP (modo JSON) en /mcp
  • Ofrece una interfaz web de métricas en /metrics cuando se autoaloja

Cuándo usarla

Buen encaje

  • Buscar modelos, datasets y Spaces del Hub desde un agente
  • Dejar que un agente llame como herramientas a apps de IA basadas en Gradio
  • Autoalojar un endpoint MCP para el Hub en tu propia infraestructura

No apto para

  • Entornos donde no es aceptable enviar un token de Hugging Face al endpoint alojado (ejecútalo en local)

Cómo instalar Hugging Face MCP Server

Necesitas: Cuenta o token de Hugging Face para las herramientas autenticadas; Node.js (npx) o Docker para ejecuciones locales

  1. Claude Code: claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login
  2. Inicia claude y sigue las instrucciones para autenticarte
  3. Gemini CLI: gemini mcp add -t http huggingface https://huggingface.co/mcp?login
  4. Cursor/VS Code: añade la url https://huggingface.co/mcp con un encabezado Authorization: Bearer
  5. Configura las herramientas y los Spaces en https://huggingface.co/settings/mcp
Ejemplo de configuración (de la documentación oficial)
"huggingface": {
    "url": "https://huggingface.co/mcp",
    "headers": {
        "Authorization": "Bearer <YOUR_HF_TOKEN>"
    }

Permisos y seguridad

A qué puede acceder

  • Acceso al Hugging Face Hub mediante tu token
  • Las herramientas de creación de repos, Jobs, Space dinámico y sandbox requieren autenticación de Hugging Face

Notas de seguridad de los responsables

  • Los clientes HTTP deben enviar un token de Hugging Face en el encabezado Authorization: Bearer; el transporte HTTP no recurre a DEFAULT_HF_TOKEN
  • MCP_STRICT_TOKEN=true rechaza con 401 las conexiones sin token
  • La interfaz /metrics es pública salvo que se defina METRICS_PAGE_PASSWORD, y no protege /mcp

Revisa el código fuente antes de dar a un agente acceso a credenciales o sistemas de producción. Documentamos lo que declaran los responsables; no auditamos el código.

Limitaciones

  • El conjunto de herramientas alojado depende de tus ajustes en huggingface.co/settings/mcp
  • El panel de actividad de skills es local al proceso y se reinicia al reiniciar

Herramientas que extiende

Programación

Claude Code

Web · Desktop

Aún no hay reseñas de usuarios

Herramienta de programación agéntica de Anthropic que lee tu código, edita archivos y ejecuta comandos desde la terminal, IDE, escritorio o navegador.

El plan gratis termina en: Sin nivel gratuito: Claude Code está incluido en las suscripciones de pago de Claude (Pro, Max, Team, Enterpr…

Listed Aún sin reseñar

Verificado code.claude.com (abre el sitio web de Claude Code en una pestaña nueva)

Desde $20/mo EE. UU. · revisado Sep 29

CompareAdded Claude Code Detalles unos Claude Code

Preguntas frecuentes

¿Cuál es la URL del servidor MCP de Hugging Face?

https://huggingface.co/mcp; añade ?login para usar el flujo de inicio de sesión. fuente

¿Cómo añado el servidor MCP de Hugging Face a Claude Code?

Ejecuta claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login, luego inicia claude y completa la autenticación. fuente

¿Puedo ejecutar el servidor MCP de Hugging Face en local?

Sí: npx @llmindset/hf-mcp-server para STDIO, npx @llmindset/hf-mcp-server-http para Streamable HTTP, o la imagen de Docker ghcr.io/evalstate/hf-mcp-server. fuente

¿Cómo limito las herramientas que expone el servidor MCP de Hugging Face?

Autoalojado, define DISABLE_TOOLS con una lista de nombres de herramientas separados por comas; alojado, configura las herramientas en huggingface.co/settings/mcp. fuente

Guías relacionadas

Fuentes y lagunas

No indicado por los responsables: Fecha de lanzamiento no visible; La lista exacta de herramientas alojadas no está en el README.

Más extensiones para ver