Spaces en tant que serveurs MCP

Vous pouvez exposer n’importe quel Space public affichant un badge MCP visible en tant qu’outil appelable, utilisable dans n’importe quel client compatible MCP, en ajoutant autant de Spaces que vous le souhaitez et sans écrire la moindre ligne de code.

Configurer votre client MCP

Depuis vos paramètres MCP du Hub, sélectionnez votre client MCP (VSCode, Cursor, Claude Code, etc.) puis suivez les instructions de configuration.

Vous avez besoin d’un jeton Hugging Face valide avec les autorisations READ pour utiliser les outils MCP. Si vous n’en avez pas, créez un nouveau jeton d’accès « Read » ici.

Ajouter un Space existant à vos outils MCP

1. Parcourez les Spaces compatibles pour trouver les Spaces utilisables via MCP. Vous pouvez également rechercher le badge gris MCP sur n’importe quelle carte de Space.
2. Cliquez sur le badge et choisissez Add to MCP tools, puis confirmez lorsque demandé.
3. Le Space doit être répertorié dans vos paramètres de serveur MCP, dans la section Spaces Tools.

Utiliser Spaces depuis votre client MCP

Si votre client MCP est correctement configuré, les Spaces que vous avez ajoutés seront immédiatement disponibles sans aucune modification (si votre client ne redémarre pas, ils devraient apparaître). La plupart des clients MCP affichent la liste des outils actuellement chargés, ce qui vous permet de vérifier que le Space est bien disponible.

Pour les Spaces ZeroGPU, votre quota est utilisé lorsque l’outil est appelé. Si vous épuisez votre quota, vous pouvez vous abonner à PRO pour obtenir 40 minutes de quota quotidien (8 fois plus de quota que les utilisateurs gratuits). Par exemple, votre compte PRO vous permet de générer jusqu’à 600 images par jour en utilisant FLUX.1-schnell.

Créez votre propre Space Gradio compatible MCP

Pour créer votre propre Space compatible MCP, vous devez créer un nouvel espace Gradio puis vous assurer d’activer la prise en charge de MCP dans le code. Commencez par les espaces Gradio et consultez le guide détaillé sur MCP pour plus de détails.

Installez d'abord Gradio avec la prise en charge de MCP :

pip install "gradio[mcp]"

Créez ensuite votre application avec des annotations de types claires et des 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

Poussez l'application vers un Gradio Space et elle recevra automatiquement le badge MCP. N'importe qui pourra ensuite l'ajouter comme outil en un seul clic.

Il est également assez simple de convertir un Space Gradio existant en serveur MCP. Dupliquez-le depuis le menu contextuel, puis ajoutez simplement le paramètre mcp_server=True à votre méthode launch(), et assurez-vous que vos fonctions disposent d’annotations de types claires et de docstrings – vous pouvez utiliser des outils d’IA pour automatiser cette tâche assez facilement (exemple de docstrings générées par IA).

Faites preuve de créativité en mélangeant des Spaces !

Étant donné que Hugging Face Spaces est le plus grand annuaire d’applications IA, vous y trouverez de nombreux outils créatifs qui peuvent être utilisés comme outils MCP. Combiner et associer différents Spaces peut donner lieu à des flux de travail puissants et créatifs.