Hub documentation

Spaces sebagai server MCP

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Spaces sebagai server MCP

Anda dapat mempublikasikan Space publik mana pun yang memiliki lencana MCP yang terlihat sebagai tool yang dapat dipanggil yang akan tersedia di klien mana pun yang kompatibel dengan MCP, Anda dapat menambahkan sebanyak mungkin Space yang diinginkan dan tanpa menulis satu baris kode pun.

Siapkan Klien MCP Anda

Dari pengaturan Hub MCP Anda, pilih klien MCP Anda (VSCode, Cursor, Claude Code, dll.) lalu ikuti instruksi pengaturannya.

image/png

Anda memerlukan token Hugging Face yang valid dengan izin READ untuk menggunakan alat MCP. Jika Anda belum memilikinya, buat token akses “Read” baru di sini.

Tambahkan Space yang sudah ada ke alat MCP Anda

image/png

  1. Jelajahi Spaces yang kompatibel untuk menemukan Spaces yang dapat digunakan melalui MCP. Anda juga dapat mencari lencana MCP berwarna abu-abu di kartu Spaces mana pun.
  2. Klik lencana dan pilih Add to MCP tools lalu konfirmasi saat diminta.
  3. Space tersebut harus terdaftar di pengaturan MCP Server Anda pada bagian Spaces Tools.

image/png

Gunakan Spaces dari klien MCP Anda

Jika klien MCP Anda dikonfigurasi dengan benar, Spaces yang Anda tambahkan akan langsung tersedia tanpa perlu mengubah apa pun (jika klien Anda tidak di-restart, maka Spaces tersebut seharusnya muncul). Sebagian besar klien MCP akan menampilkan daftar tool yang saat ini dimuat sehingga Anda dapat memastikan bahwa Space tersebut tersedia.

Untuk ZeroGPU Spaces, kuota Anda akan terpakai saat tool dipanggil. Jika kuota Anda habis, Anda dapat berlangganan PRO untuk mendapatkan kuota harian 40 menit (8x lebih banyak kuota daripada pengguna gratis). Sebagai contoh, akun PRO Anda memungkinkan Anda menghasilkan hingga 600 gambar per hari menggunakan FLUX.1-schnell.

Bangun Gradio Space yang kompatibel dengan MCP Anda sendiri

Untuk membuat Space yang mendukung MCP Anda sendiri, Anda perlu membuat Gradio Space baru lalu pastikan untuk mengaktifkan dukungan MCP di kode. Mulai dengan Gradio Spaces dan pastikan untuk memeriksa panduan MCP terperinci untuk detail lebih lanjut.

Pertama, instal Gradio dengan dukungan MCP:

pip install "gradio[mcp]"

Lalu buat aplikasi Anda dengan type hints dan docstrings yang jelas:

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

Dorong aplikasi ke Gradio Space dan aplikasi tersebut akan secara otomatis menerima lencana MCP. Siapa pun kemudian dapat menambahkannya sebagai alat dengan satu klik.

Mengubah Gradio Space yang sudah ada menjadi server MCP juga cukup mudah. Duplikat dari menu konteks lalu tambahkan parameter mcp_server=True ke metode launch() Anda, dan pastikan fungsi Anda memiliki type hints dan docstring yang jelas - Anda dapat menggunakan alat AI untuk mengotomatisasi ini dengan cukup mudah (contoh docstring yang dihasilkan AI).

Berkreasilah dengan mencampur Spaces!

Karena Hugging Face Spaces adalah direktori aplikasi AI terbesar, Anda dapat menemukan banyak alat kreatif yang dapat digunakan sebagai alat MCP. Mencampur dan mencocokkan berbagai Spaces dapat menghasilkan alur kerja yang kuat dan kreatif.

Video ini mendemonstrasikan penggunaan Lightricks/ltx-video-distilled dan ResembleAI/Chatterbox di Claude Code untuk menghasilkan video dengan audio.
Update on GitHub