Hub documentation
Hugging Face MCP Server
Hugging Face MCP Server
Máy chủ MCP (Model Context Protocol) của Hugging Face kết nối trợ lý AI tương thích MCP của bạn (ví dụ như Codex, Cursor, các extension của VS Code, Zed, ChatGPT hoặc Claude Desktop) trực tiếp với Hugging Face Hub. Sau khi kết nối, trợ lý của bạn có thể tìm kiếm và khám phá các tài nguyên trên Hub cũng như sử dụng các công cụ của cộng đồng, tất cả đều ngay trong trình soạn thảo, khung chat hoặc CLI của bạn.
Những gì bạn có thể làm
- Tìm kiếm và khám phá các tài nguyên trên Hub: mô hình, bộ dữ liệu, Spaces, bài báo và nhiều hơn nữa.
- Tìm kiếm tài liệu Hugging Face bằng các truy vấn ngôn ngữ tự nhiên.
- Lập lịch và chạy các Job và sử dụng các sandbox
- Chạy các công cụ cộng đồng thông qua các ứng dụng Gradio tương thích MCP được lưu trữ trên Spaces.
- Mang kết quả trở lại trợ lý của bạn với metadata, liên kết và ngữ cảnh.
Bắt đầu
Mở cài đặt MCP của bạn khi đã đăng nhập.
Chọn client của bạn: chọn client tương thích MCP của bạn (ví dụ Cursor, VS Code, Zed, Claude Desktop). Trang hiển thị các hướng dẫn cụ thể cho từng client và một đoạn cấu hình sẵn sàng để sao chép.
Dán và khởi động lại: sao chép đoạn mã vào cấu hình MCP của client, lưu lại, sau đó khởi động lại/tải lại client. Bạn sẽ thấy “Hugging Face” (hoặc tương tự) được liệt kê như một máy chủ MCP đã kết nối trong client của bạn.
Trang cài đặt tạo ra cấu hình chính xác mà client của bạn mong đợi. Hãy sử dụng trang này thay vì tự viết cấu hình thủ công.
Sử dụng máy chủ
Sau khi kết nối, hãy yêu cầu trợ lý của bạn sử dụng các công cụ của Hugging Face. Các câu lệnh mẫu:
- “Tìm kiếm các mô hình Hugging Face cho Qwen 3.6 Quantizations.”
- “Tìm một Space có thể chuyển đổi tệp âm thanh thành văn bản.”
- “Hiển thị các bộ dữ liệu về chuỗi thời gian thời tiết.”
- “Tạo một hình ảnh 1024 x 1024 của một con mèo theo phong cách ghibli.”
- “Làm thế nào để sử dụng bộ thích ứng LoRA với PEFT?” (sử dụng Tìm kiếm Ngữ nghĩa Tài liệu)
- “Tìm các bài báo về mô hình thị giác-ngôn ngữ.”
Trợ lý của bạn sẽ điều hướng Hub bằng các công cụ được cung cấp bởi MCP Server (bao gồm các Spaces bạn đã chọn, như được hiển thị trong phần tiếp theo) và trả về kết quả (tiêu đề, chủ sở hữu, lượt tải xuống, liên kết, v.v.). Sau đó, bạn có thể mở tài nguyên trên Hub hoặc tiếp tục lặp lại trong cùng một cuộc trò chuyện.
Công cụ tích hợp sẵn
Hầu hết các tác vụ trên Hub có thể được hoàn thành một cách hiệu quả bằng công cụ hf_fs tích hợp sẵn. Công cụ này cho phép trợ lý của bạn điều hướng Hub một cách hiệu quả, bao gồm cả tìm kiếm ngữ nghĩa trên Documents và Spaces.
Bạn có thể cấu hình các công cụ bổ sung từ trang cấu hình MCP của bạn.
| Công cụ | Mô tả |
|---|---|
| Đóng góp kho | Tạo và ghi tệp vào các kho đã tạo |
| Phòng thí nghiệm ảo | Tạo và sử dụng Sandboxes: bao gồm quản lý tệp Sandbox |
| Chạy và quản lý các tác vụ | Chạy, giám sát và lên lịch các tác vụ trên hạ tầng của Hugging Face. |
Các công cụ thử nghiệm được thêm vào theo từng giai đoạn. Hãy thử chúng và phản hồi xem chúng có cải thiện trải nghiệm của bạn hay không tại đây
Thêm các công cụ cộng đồng (Spaces)
Bạn có thể mở rộng cấu hình của mình bằng các Gradio Spaces tương thích MCP do cộng đồng xây dựng:
- Khám phá Spaces với hỗ trợ MCP tại đây.
- Thêm Space liên quan vào cài đặt MCP của bạn trên Hugging Face tại đây.
Ứng dụng Gradio MCP công khai các hàm của chúng dưới dạng công cụ (kèm theo các đối số và mô tả) để trợ lý của bạn có thể gọi chúng trực tiếp. Vui lòng khởi động lại hoặc làm mới client để nó nhận các công cụ mới mà bạn thêm.
Xem hướng dẫn chuyên sâu của chúng tôi về Spaces dưới dạng máy chủ MCP tại đây.
Tùy chọn Spaces
Cài đặt MCP của bạn cung cấp một số tùy chọn để tùy chỉnh cách Spaces hoạt động:
| Tùy chọn | Mô tả |
|---|---|
| Dynamic Spaces | Gọi các MCP Spaces một cách động khi chạy. Khi được bật, trợ lý của bạn có thể khám phá và sử dụng các Space tương thích MCP một cách tức thời mà không cần thêm chúng thủ công. |
| Loại bỏ hình ảnh nhúng | Xóa các hình ảnh nhúng được tạo bởi Gradio Spaces. Hữu ích nếu client MCP của bạn có hỗ trợ hình ảnh hạn chế hoặc bạn muốn nhận phản hồi chỉ bằng văn bản. |
Tìm hiểu thêm
- Cài đặt cấu hình và client: https://huggingface.co/settings/mcp
- Thông báo bản cập nhật: https://huggingface.co/changelog/hf-mcp-server
- Hugging Face MCP Server: https://huggingface.co/mcp
- Tự xây dựng MCP Server của bạn với Gradio Spaces: https://www.gradio.app/guides/building-mcp-server-with-gradio