Hub documentation
Spaces dưới dạng máy chủ MCP
Spaces dưới dạng máy chủ MCP
Bạn có thể biến bất kỳ Space công khai nào có huy hiệu MCP hiển thị thành một công cụ có thể gọi được, công cụ này sẽ khả dụng trong mọi client tương thích MCP, bạn có thể thêm bao nhiêu Space tùy ý mà không cần viết một dòng code nào.
Cài đặt MCP Client
Từ cài đặt Hub MCP của bạn, hãy chọn client MCP (VSCode, Cursor, Claude Code, v.v.) rồi làm theo các hướng dẫn thiết lập.

Bạn cần một token Hugging Face hợp lệ có quyền READ để sử dụng các công cụ MCP. Nếu bạn chưa có, hãy tạo một token truy cập “Read” mới tại đây.
Thêm một Space hiện có vào các công cụ MCP của bạn

- Duyệt các Spaces tương thích để tìm các Spaces có thể sử dụng qua MCP. Bạn cũng có thể tìm huy hiệu MCP màu xám trên bất kỳ thẻ Spaces nào.
- Nhấp vào huy hiệu và chọn Add to MCP tools sau đó xác nhận khi được hỏi.
- Space phải được liệt kê trong cài đặt MCP Server của bạn ở phần Spaces Tools.

Sử dụng Spaces từ client MCP của bạn
Nếu client MCP của bạn được cấu hình đúng, các Space bạn đã thêm sẽ có sẵn ngay lập tức mà không cần thay đổi gì (nếu nó không khởi động lại client của bạn và nó nên xuất hiện). Hầu hết các client MCP sẽ liệt kê các công cụ hiện đang được nạp để bạn có thể đảm bảo Space đó khả dụng.
Đối với ZeroGPU Spaces, hạn mức của bạn sẽ được sử dụng khi công cụ được gọi. Nếu bạn hết hạn mức, bạn có thể đăng ký PRO để nhận 40 phút hạn mức hàng ngày (gấp 8 lần hạn mức của người dùng miễn phí). Ví dụ, tài khoản PRO của bạn cho phép bạn tạo tối đa 600 hình ảnh mỗi ngày bằng FLUX.1-schnell.
Tự xây dựng Gradio Space tương thích MCP
Để tạo Space hỗ trợ MCP của riêng bạn, bạn cần Tạo một Gradio Space mới sau đó đảm bảo bật hỗ trợ MCP trong mã. Bắt đầu với Gradio Spaces và hãy chắc chắn kiểm tra hướng dẫn MCP chi tiết để biết thêm chi tiết.
Đầu tiên, cài đặt Gradio với hỗ trợ MCP:
pip install "gradio[mcp]"Sau đó, tạo ứng dụng của bạn với các chú thích kiểu rõ ràng và docstring:
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Đẩy ứng dụng lên Gradio Space và nó sẽ tự động nhận huy hiệu MCP. Sau đó, bất kỳ ai cũng có thể thêm nó như một công cụ chỉ với một cú nhấp chuột.
Việc chuyển đổi một Gradio Space hiện có thành MCP server cũng khá dễ dàng. Nhân bản nó từ menu ngữ cảnh, sau đó chỉ cần thêm tham số
mcp_server=Truevào phương thứclaunch()của bạn, và đảm bảo các hàm của bạn có type hints và docstrings rõ ràng - bạn có thể sử dụng các công cụ AI để tự động hóa việc này một cách khá dễ dàng (ví dụ về docstrings do AI tạo ra).
Hãy sáng tạo bằng cách kết hợp các Spaces!
Vì Hugging Face Spaces là thư mục ứng dụng AI lớn nhất, bạn có thể tìm thấy nhiều công cụ sáng tạo có thể được sử dụng như các công cụ MCP. Kết hợp và phối hợp các Spaces khác nhau có thể tạo ra các quy trình làm việc mạnh mẽ và sáng tạo.