Spaces como servidores MCP

Puedes exponer cualquier Space público que tenga una insignia MCP visible como una herramienta invocable que estará disponible en cualquier cliente compatible con MCP, puedes añadir tantos Spaces como quieras y sin escribir una sola línea de código.

Configura tu cliente MCP

Desde tus configuraciones de MCP de Hub, selecciona tu cliente MCP (VSCode, Cursor, Claude Code, etc.) y luego sigue las instrucciones de configuración.

Necesitas un token de Hugging Face válido con permisos de READ para usar las herramientas MCP. Si no tienes uno, crea un nuevo token de acceso “Read” aquí.

Agrega un Space existente a tus herramientas MCP

1. Explora los Spaces compatibles para encontrar Spaces que se pueden usar mediante MCP. También puedes buscar la insignia gris MCP en cualquier tarjeta de Spaces.
2. Haz clic en la insignia y elige Add to MCP tools y, a continuación, confirma cuando se te solicite.
3. El Space debe aparecer en la configuración de tu servidor MCP, en la sección Spaces Tools.

Usa Spaces desde tu cliente de MCP

Si tu cliente MCP está configurado correctamente, los Spaces que añadiste estarán disponibles de inmediato sin necesidad de cambiar nada (si no se reinicia tu cliente y debería aparecer). La mayoría de los clientes MCP enumeran las herramientas que están cargadas actualmente para que puedas asegurarte de que el Space está disponible.

Para los Spaces de ZeroGPU, tu cuota se utilizará cuando se invoque la herramienta. Si agotas tu cuota, puedes suscribirte a PRO para obtener 40 minutos de cuota diaria (8 veces más cuota que los usuarios gratuitos). Por ejemplo, tu cuenta PRO te permite generar hasta 600 imágenes al día usando FLUX.1-schnell.

Crea tu propio Espacio de Gradio compatible con MCP

Para crear tu propio Space habilitado para MCP, necesitas crear un nuevo Space de Gradio y luego asegurarte de habilitar el soporte de MCP en el código. Comienza con Gradio Spaces y asegúrate de consultar la guía detallada de MCP para obtener más detalles.

Primero, instala Gradio con soporte para MCP:

pip install "gradio[mcp]"

Luego, crea tu aplicación con anotaciones de tipos claras y docstrings:

import gradio as gr

def letter_counter(word: str, letter: str) -> int:
    """Count occurrences of a letter in a word.
    
    Args:
        word: The word to search in
        letter: The letter to count
        
    Returns:
        Number of times the letter appears in the word
    """
    return word.lower().count(letter.lower())

demo = gr.Interface(fn=letter_counter,
                    inputs=["text", "text"],
                    outputs="number")
demo.launch(mcp_server=True)   # exposes an MCP schema automatically

Sube la aplicación a un Gradio Space y recibirá automáticamente la insignia de MCP. Cualquier persona podrá luego añadirla como herramienta con un solo clic.

También es bastante fácil convertir un Space de Gradio existente en un servidor MCP. Duplica el Space desde el menú de contexto y luego añade el parámetro mcp_server=True a tu método launch(), y asegúrate de que tus funciones tengan type hints y docstrings claros; puedes usar herramientas de IA para automatizar esto con bastante facilidad (ejemplo de docstrings generados por IA).

¡Sé creativo mezclando Spaces!

Dado que Hugging Face Spaces es el directorio más grande de aplicaciones de IA, puedes encontrar muchas herramientas creativas que se pueden usar como herramientas MCP. Combinar y mezclar diferentes Spaces puede dar lugar a flujos de trabajo potentes y creativos.