Overview
Features
Gradio MCP Support (SSE)
Gradio 5.28 adds integrated MCP support via SSE, enabling MCP endpoints for Spaces.
Default HuggingFace Spaces integration
Automatically connects to a default image-generation Space (black-forest-labs/FLUX.1-schnell) and exposes it via MCP to Claude Desktop.
Working directory management
Configurable work directory for file uploads/downloads; override with --work-dir or MCP_HF_WORK_DIR.
HF Token and Private Spaces
Supports private Spaces using a HuggingFace token via --hf-token or HF_TOKEN env var.
Multiple server instances
Supports running multiple server instances with different working directories and tokens.
Claude Desktop mode behavior
In Claude Desktop mode, images are returned in tool responses and other files saved to the working directory with their paths returned.
API Endpoint customization
You can specify specific API endpoints by using a sub-path on the spacename, e.g., model_chat.
Who Is This For?
- Claude Desktop users:Configure and run Hugging Face Spaces MCP endpoints within Claude Desktop.
- MCP Developers:Set up MCP endpoints and configurations for multiple spaces in Claude Desktop.
- HuggingFace Space Admins:Manage private spaces and tokens for production MCP usage at scale.




