Hub documentation
Hugging Face MCP Sunucusu
Hugging Face MCP Sunucusu
Hugging Face MCP (Model Context Protocol) Sunucusu, MCP uyumlu yapay zeka asistanınızı (örneğin Codex, Cursor, VS Code eklentileri, Zed, ChatGPT veya Claude Desktop) doğrudan Hugging Face Hub'a bağlar. Bağlantı kurulduktan sonra asistanınız, Hub kaynaklarını arayıp keşfedebilir ve topluluk araçlarını kullanabilir; tüm bunları editörünüzden, sohbet pencerenizden veya CLI'dan yapabilirsiniz.
Yapabilecekleriniz
- Hub kaynaklarını arayın ve keşfedin: modeller, veri kümeleri, Spaces, makaleler ve daha fazlası.
- Hugging Face dokümantasyonunu doğal dil sorgularıyla arayın.
- İşleri zamanla ve çalıştırın ve kum havuzlarını kullanın
- Spaces üzerinde barındırılan MCP uyumlu Gradio uygulamaları aracılığıyla topluluk araçlarını çalıştırın.
- Sonuçları, meta veriler, bağlantılar ve bağlamla asistanınıza geri getirin.
Başlayın
Giriş yapmışken MCP ayarlarınızı açın.
İstemcininizi seçin: MCP uyumlu istemcinizi seçin (örneğin Cursor, VS Code, Zed, Claude Desktop). Sayfa, istemcine özgü talimatları ve kopyalamaya hazır bir yapılandırma parçasını gösterir.
Yapıştır ve yeniden başlat: parçayı istemcinizin MCP yapılandırmasına kopyalayın, kaydedin ve istemciyi yeniden başlatın/yenileyin. İstemcinizde bağlı bir MCP sunucusu olarak “Hugging Face” (veya benzeri) listelenmelidir.
Ayarlar sayfası, istemcinizin beklediği tam yapılandırmayı oluşturur. Yapılandırmayı elle yazmak yerine bunu kullanın.
Sunucuyu kullanma
Bağlantı kurulduktan sonra asistanınızdan Hugging Face araçlarını kullanmasını isteyin. Örnek istemler:
- “Qwen 3.6 Quantizations için Hugging Face modellerini arayın.”
- “Ses dosyalarını transkribe edebilen bir Space bulun.”
- “Hava durumu zaman serileri hakkında veri kümelerini göster.”
- “Ghibli tarzında bir kedi içeren 1024 x 1024 boyutunda bir görüntü oluşturun.”
- “PEFT ile LoRA adaptörlerini nasıl kullanırım?” (Documentation Semantic Search kullanır)
- “Görüntü-dil modelleri hakkında makaleler bulun.”
Asistanınız, MCP Sunucusu tarafından sağlanan araçları (bir sonraki bölümde gösterildiği gibi seçtiğiniz Spaces dahil) kullanarak Hub'da gezinir ve sonuçları (başlıklar, sahipler, indirme sayıları, bağlantılar vb.) döndürür. Ardından kaynağı Hub'da açabilir veya aynı sohbette işlemeye devam edebilirsiniz.
Yerleşik Araçlar
Hub'daki çoğu görev, yerleşik hf_fs aracıyla verimli bir şekilde tamamlanabilir. Bu araç, asistanınızın Hub'da gezinmesini, belgelerin ve Spaces'lerin anlamsal aramalarını yapmasını sağlar.
Ekstra araçları MCP ayarları sayfanızdan yapılandırabilirsiniz.
| Araç | Açıklama |
|---|---|
| Katkıda Bulunabileceğiniz Depolar | Oluşturulan depolara dosyalar oluşturun ve yazın |
| Kum Havuzları | Sandboxes oluşturma ve kullanma: Sandbox dosya yönetimi içerir |
| İşleri Çalıştır ve Yönet | Hugging Face altyapısında işleri çalıştırın, izleyin ve zamanlayın. |
Deneysel araçlar zaman zaman eklenir. Bunları deneyin ve deneyiminizi iyileştirip iyileştirmediğini buradan bildirin.
Topluluk araçlarını (Spaces) ekleyin
Kurulumunuzu, topluluk tarafından oluşturulan MCP uyumlu Gradio Spaces ile genişletebilirsiniz:
- MCP desteğine sahip Spaces'i burada keşfedin.
- Hugging Face'teki MCP ayarlarınıza ilgili Space'i buradan ekleyin.
Gradio MCP uygulamaları, fonksiyonlarını (argümanları ve açıklamalarıyla birlikte) araçlar olarak açığa çıkarır; böylece asistanınız bunları doğrudan çağırabilir. Eklediğiniz yeni araçların algılanabilmesi için istemcinizi yeniden başlatmanız veya yenilemeniz gerekir.
Spaces'in MCP sunucuları olarak kullanımı için hazırladığımız ayrıntılı rehberi burada inceleyebilirsiniz.
Spaces seçenekleri
MCP ayarlarınız, Spaces'in nasıl çalışacağını özelleştirmek için çeşitli seçenekler sunar:
| Seçenek | Açıklama |
|---|---|
| Dinamik Uzaylar | MCP Spaces'ı çalışma zamanında dinamik olarak çağırın. Etkinleştirildiğinde, asistanınız MCP ile uyumlu Spaces'ı manuel olarak eklemeye gerek kalmadan anında keşfedebilir ve kullanabilir. |
| Gömülü Görselleri Kaldır | Gradio Spaces tarafından oluşturulan gömülü görselleri kaldırır. MCP istemcinizin sınırlı görsel desteği varsa veya yalnızca metin tabanlı yanıtlar istiyorsanız faydalıdır. |
Daha fazla bilgi edinin
- Ayarlar ve istemci kurulumu: https://huggingface.co/settings/mcp
- Değişiklik günlüğü duyurusu: https://huggingface.co/changelog/hf-mcp-server
- Hugging Face MCP Sunucusu: https://huggingface.co/mcp
- Gradio Spaces ile kendi MCP Sunucunuzu oluşturun: https://www.gradio.app/guides/building-mcp-server-with-gradio