HuggingFace Spaces
Created 6 months ago
MCP server for Hugging Face services with Gradio support.
What is HuggingFace Spaces?
Server for using HuggingFace Spaces, supporting Open Source Image, Audio, Text Models and more. Claude Desktop mode for easy integration.
Documentation
mcp-hfspace MCP Server
You can access and configure Hugging Face MCP services directly at https://hf.co/mcp, including Gradio spaces.
This project has been superceded by the official Hugging Face MCP Server and Gradio MCP Endpoints.
Alternatively you can run hf-mcp-server locally as a STDIO Server, or with robust support for SSE, Streaming HTTP and Streaming HTTP JSON Mode. This also runs a local UI for selecting tools and endpoints and supports ToolListChangedNotifications too.
Installation
NPM Package is @llmindset/mcp-hfspace. Install a recent version of NodeJS for your platform, then add the following to the mcpServers section of your claude_desktop_config.json file:
"mcp-hfspace": {
"command": "npx",
"args": [ "-y", "@llmindset/mcp-hfspace" ]
}
Please make sure you are using Claude Desktop 0.78 or greater. This will get you started with an Image Generator.
Recommended Spaces
- Image Generation: shuttleai/shuttle-3.1-aesthetic, black-forest-labs/FLUX.1-schnell
- Chat: Qwen/Qwen2.5-72B-Instruct
- Text-to-speech: fantaxy/Sound-AI-SFX
- Speech-to-text: hf-audio/whisper-large-v3-turbo
Known Issues and Limitations
- Endpoints with unnamed parameters are unsupported for the moment.
- Claude Desktop 0.75 doesn't seem to respond to errors from the MCP Server, timing out instead.
Server Config
{
"mcpServers": {
"huggingface-spaces-server": {
"command": "npx",
"args": [
"huggingface-spaces"
]
}
}
}