Hub documentation

MCP sunucuları olarak Spaces

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

MCP sunucuları olarak Spaces

görünür bir MCP rozeti bulunan herkese açık herhangi bir Space'i çağrılabilir bir araca dönüştürebilirsiniz; bu araç, kod satırı yazmadan istediğiniz kadar Space ekleyebileceğiniz herhangi bir MCP uyumlu istemcide kullanılabilir olacaktır.

MCP İstemcinizi Yapılandırın

Hub MCP ayarlarınızdan MCP istemcinizi (VSCode, Cursor, Claude Code vb.) seçin ve ardından kurulum talimatlarını izleyin.

image/png

MCP araçlarını kullanmak için READ izinlerine sahip geçerli bir Hugging Face jetonu gereklidir. Elinizde böyle bir jeton yoksa, buradan yeni bir “Read” erişim jetonu oluşturabilirsiniz.

MCP araçlarınıza mevcut bir Space ekleyin

image/png

  1. Uyumlu Spaces’leri gözden geçirerek MCP üzerinden kullanılabilir Spaces’leri bulabilirsiniz. Ayrıca herhangi bir Spaces kartındaki gri MCP rozetini arayabilirsiniz.
  2. Rozete tıklayın, MCP araçlarına ekle seçeneğini seçin ve istendiğinde onaylayın.
  3. Space, Spaces Tools bölümündeki MCP Server ayarlarınızda listelenmelidir.

image/png

MCP istemcinizden Spaces kullanın

MCP istemciniz doğru yapılandırıldıysa, eklediğiniz Spaces hiçbir değişiklik yapmadan anında kullanılabilir hale gelir (istemcinizi yeniden başlatmazsa ve görünmesi gerekiyorsa). Çoğu MCP istemcisi, Space'in kullanılabilir olduğundan emin olmanız için şu anda yüklü olan araçları listeler.

ZeroGPU Spaces için, araç çağrıldığında kota kullanılır. Kota biterse, ücretsiz kullanıcılara göre 8 kat daha fazla kota olan günlük 40 dakikalık kotaya erişmek için PRO'ya abone olabilirsiniz. Örneğin PRO hesabınız, FLUX.1-schnell kullanarak günde en fazla 600 görsel üretmenizi sağlar.

Kendi MCP uyumlu Gradio Space'inizi oluşturun

Kendi MCP destekli Space'inizi oluşturmak için yeni bir Gradio Space oluşturmanız ve ardından kodda MCP desteğini etkinleştirmeniz gerekir. Gradio Spaces ile başlayın ve daha fazla ayrıntı için detaylı MCP kılavuzunu kontrol edin.

Önce MCP desteğiyle Gradio'yu yükleyin:

pip install "gradio[mcp]"

Ardından uygulamanızı açık tip ipuçları ve dokümantasyon dizeleriyle oluşturun:

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

Uygulamayı bir Gradio Space adresine gönderin; otomatik olarak MCP rozetini alır. Ardından herkes, tek tıkla bunu bir araç olarak ekleyebilir.

Mevcut bir Gradio Space’i MCP sunucusuna dönüştürmek de oldukça kolaydır. Bağlam menüsünden kopyasını alıp launch() yönteminize mcp_server=True parametresini eklemeniz yeterlidir; ayrıca işlevlerinizin açık tip ipuçlarına ve docstring’lere sahip olduğundan emin olun. Bu işlemi yapay zeka araçlarıyla oldukça kolay bir şekilde otomatikleştirebilirsiniz (yapay zeka tarafından üretilmiş docstring’lere örnek).

Spaces'ı karıştırarak yaratıcı olun!

Hugging Face Spaces, yapay zeka uygulamalarının en büyük dizini olduğu için, MCP araçları olarak kullanılabilecek birçok yaratıcı aracı bulabilirsiniz. Farklı Spaces'leri bir araya getirmek, güçlü ve yaratıcı iş akışlarına yol açabilir.

Bu video, Lightricks/ltx-video-distilled ve ResembleAI/Chatterbox'in Claude Code içinde sesli bir video oluşturmak için nasıl kullanıldığını göstermektedir.
Update on GitHub