Serveur MCP Hugging Face

Le serveur MCP (Model Context Protocol) de Hugging Face connecte votre assistant IA compatible MCP (par exemple Codex, Cursor, les extensions VS Code, Zed, ChatGPT ou Claude Desktop) directement au Hugging Face Hub. Une fois la connexion établie, votre assistant peut rechercher et explorer les ressources du Hub et utiliser les outils de la communauté, le tout depuis votre éditeur, votre chat ou votre CLI.

Ce que vous pouvez faire

• Rechercher et explorer les ressources du Hub : modèles, jeux de données, Spaces, articles et plus encore.
• Recherchez dans la documentation Hugging Face à l'aide de requêtes en langage naturel.
• Planifier et exécuter des Jobs et utiliser des sandboxes
• Exécutez les outils de la communauté via des applications Gradio compatibles MCP hébergées sur Spaces.
• Rapportez les résultats à votre assistant avec métadonnées, liens et contexte.

Commencer

1. Ouvrez vos paramètres MCP en étant connecté.

2. Choisissez votre client : sélectionnez votre client compatible MCP (par exemple Cursor, VS Code, Zed, Claude Desktop). La page affiche des instructions spécifiques au client et un extrait de configuration prêt à être copié.

3. Coller et redémarrer : copiez l’extrait dans la configuration MCP de votre client, enregistrez, puis redémarrez ou rechargez le client. Vous devriez voir « Hugging Face » (ou similaire) répertorié en tant que serveur MCP connecté dans votre client.

La page de paramètres génère la configuration exacte attendue par votre client. Utilisez-la plutôt que d’écrire la configuration à la main.

Utiliser le serveur

Après la connexion, demandez à votre assistant d'utiliser les outils Hugging Face. Exemples de prompts :

• “Rechercher les modèles Qwen 3.6 Quantizations sur Hugging Face.”
• “Trouvez un Space capable de transcrire des fichiers audio.”
• “Afficher les jeux de données sur les séries temporelles météorologiques.”
• “Créez une image de 1024 x 1024 d'un chat dans le style Ghibli.”
• « Comment utiliser les adaptateurs LoRA avec PEFT ? » (utilise la recherche sémantique de la documentation)
• “Trouver des articles sur les modèles vision-langage.”

Votre assistant naviguera sur le Hub à l’aide des outils exposés par le MCP Server (y compris les Spaces que vous avez sélectionnés, comme indiqué dans la section suivante) et renverra les résultats (titres, propriétaires, téléchargements, liens, etc.). Vous pourrez ensuite ouvrir la ressource sur le Hub ou continuer à itérer dans la même conversation.

Outils intégrés

La plupart des tâches du Hub peuvent être réalisées efficacement à l’aide de l’outil intégré hf_fs. Il permet à votre assistant de naviguer efficacement sur le Hub, y compris des recherches sémantiques dans les Documents et les Spaces.

Vous pouvez configurer des outils supplémentaires depuis votre page paramètres MCP.

Outil	Description
Contribuer aux dépôts	Créer et écrire des fichiers dans les dépôts créés
Environnements isolés	Créer et utiliser des Sandboxes : inclut la gestion des fichiers Sandbox
Exécuter et gérer des tâches	Exécutez, surveillez et planifiez des tâches sur l'infrastructure Hugging Face.

Des outils expérimentaux sont ajoutés de temps en temps. Essayez-les et indiquez-nous s’ils améliorent votre expérience ici

Ajouter des outils communautaires (Spaces)

Vous pouvez étendre votre configuration avec des Gradio Spaces compatibles MCP créés par la communauté :

• Explorez les Spaces avec la prise en charge de MCP ici.
• Ajoutez le Space pertinent dans vos paramètres MCP sur Hugging Face ici.

Les applications Gradio MCP exposent leurs fonctions en tant qu'outils (avec des arguments et des descriptions) afin que votre assistant puisse les appeler directement. Veuillez redémarrer ou actualiser votre client pour qu'il détecte les nouveaux outils que vous ajoutez.

Consultez notre guide dédié aux Spaces en tant que serveurs MCP ici.

Options des Spaces

Vos paramètres MCP offrent plusieurs options pour personnaliser le fonctionnement des Spaces :

Option	Description
Espaces dynamiques	Appel dynamique des Spaces MCP à l’exécution. Une fois activé, votre assistant peut découvrir et utiliser des Spaces compatibles MCP à la volée, sans avoir à les ajouter manuellement.
Supprimer les images intégrées	Supprimez les images intégrées générées par Gradio Spaces. Utile si votre client MCP a une prise en charge limitée des images ou si vous souhaitez des réponses uniquement en texte.

En savoir plus

• Paramètres et configuration du client : https://huggingface.co/settings/mcp
• Annonce du journal des modifications : https://huggingface.co/changelog/hf-mcp-server
• Serveur MCP Hugging Face : https://huggingface.co/mcp
• Créez votre propre serveur MCP avec Gradio Spaces : https://www.gradio.app/guides/building-mcp-server-with-gradio

Update on GitHub