Hub documentation
Hugging Face MCP Server
Hugging Face MCP Server
Server MCP (Model Context Protocol) Hugging Face menghubungkan asisten AI Anda yang kompatibel dengan MCP (misalnya Codex, Cursor, ekstensi VS Code, Zed, ChatGPT, atau Claude Desktop) secara langsung ke Hugging Face Hub. Setelah terhubung, asisten Anda dapat mencari dan menjelajahi sumber daya Hub serta menggunakan alat komunitas, semuanya dari dalam editor, chat, atau CLI Anda.
Yang dapat Anda lakukan
- Cari dan jelajahi sumber daya Hub: model, dataset, Spaces, paper, dan lainnya.
- Cari dokumentasi Hugging Face dengan kueri bahasa alami.
- Jadwalkan dan jalankan Jobs serta gunakan sandboxes
- Jalankan alat komunitas melalui aplikasi Gradio yang kompatibel dengan MCP yang dihosting di Spaces.
- Bawa hasil kembali ke asisten Anda dengan metadata, tautan, dan konteks.
Mulai
Buka pengaturan MCP Anda saat sudah masuk.
Pilih klien Anda: pilih klien yang kompatibel dengan MCP (misalnya Cursor, VS Code, Zed, Claude Desktop). Halaman menampilkan instruksi khusus klien dan potongan konfigurasi yang siap disalin.
Tempel dan mulai ulang: salin snippet ke konfigurasi MCP klien Anda, simpan, lalu mulai ulang/muat ulang klien. Anda seharusnya melihat “Hugging Face” (atau serupa) terdaftar sebagai server MCP yang terhubung di klien Anda.
Halaman pengaturan menghasilkan konfigurasi persis yang diharapkan oleh klien Anda. Gunakan halaman ini alih-alih menulis konfigurasi secara manual.
Menggunakan server
Setelah terhubung, minta asisten Anda untuk menggunakan alat Hugging Face. Contoh prompt:
- “Cari model Hugging Face untuk Qwen 3.6 Quantizations.”
- “Temukan Space yang dapat mentranskripsi file audio.”
- “Tampilkan dataset tentang deret waktu cuaca.”
- “Buat gambar 1024 x 1024 seekor kucing bergaya ghibli.”
- “Bagaimana cara menggunakan adapter LoRA dengan PEFT?” (menggunakan Pencarian Semantik Dokumentasi)
- “Cari makalah tentang model bahasa-visi.”
Asisten Anda akan menavigasi Hub menggunakan tools yang diungkap oleh MCP Server (termasuk Spaces yang telah Anda pilih, seperti yang ditunjukkan di bagian berikutnya) dan mengembalikan hasil (judul, pemilik, unduhan, tautan, dan sebagainya). Anda kemudian dapat membuka sumber daya di Hub atau terus beriterasi di chat yang sama.
Alat Bawaan
Sebagian besar tugas Hub dapat diselesaikan secara efisien dengan alat bawaan hf_fs. Alat ini memungkinkan asisten Anda menavigasi Hub secara efisien, termasuk pencarian semantik pada Documents dan Spaces.
Anda dapat mengonfigurasi alat tambahan dari halaman pengaturan MCP Anda.
| Alat | Deskripsi |
|---|---|
| Repositori Kontribusi | Buat dan tulis file ke repositori yang telah dibuat tersebut |
| Sandboxes | Membuat dan menggunakan Sandboxes: mencakup manajemen file Sandbox |
| Jalankan dan Kelola Pekerjaan | Jalankan, pantau, dan jadwalkan pekerjaan pada infrastruktur Hugging Face. |
Alat eksperimental ditambahkan dari waktu ke waktu. Cobalah dan berikan umpan balik apakah mereka meningkatkan pengalaman Anda di sini
Tambahkan alat komunitas (Spaces)
Anda dapat memperluas setup Anda dengan Gradio Spaces yang kompatibel dengan MCP dan dibangun oleh komunitas:
- Jelajahi Spaces dengan dukungan MCP di sini.
- Tambahkan Space yang relevan di pengaturan MCP Anda di Hugging Face di sini.
Aplikasi Gradio MCP mengekspos fungsinya sebagai alat (dengan argumen dan deskripsi) sehingga asisten Anda dapat memanggilnya secara langsung. Silakan mulai ulang atau perbarui klien Anda agar alat baru yang Anda tambahkan dapat terdeteksi.
Lihat panduan khusus kami untuk Spaces sebagai server MCP di sini.
Opsi Spaces
Pengaturan MCP Anda menyediakan beberapa opsi untuk menyesuaikan cara kerja Spaces:
| Opsi | Deskripsi |
|---|---|
| Ruang Dinamis | Panggil MCP Spaces secara dinamis saat runtime. Saat diaktifkan, asisten Anda dapat menemukan dan menggunakan Spaces yang kompatibel dengan MCP secara langsung tanpa perlu menambahkannya secara manual. |
| Hapus Gambar Tertanam | Hapus gambar tertanam yang dihasilkan oleh Gradio Spaces. Berguna jika klien MCP Anda memiliki dukungan gambar terbatas atau Anda menginginkan respons hanya berupa teks. |
Pelajari lebih lanjut
- Pengaturan dan konfigurasi klien: https://huggingface.co/settings/mcp
- Pengumuman changelog: https://huggingface.co/changelog/hf-mcp-server
- Hugging Face MCP Server: https://huggingface.co/mcp
- Bangun Server MCP Anda sendiri dengan Gradio Spaces: https://www.gradio.app/guides/building-mcp-server-with-gradio