Loading...
The `mcp-hfspace` server connects Claude Desktop to Hugging Face Spaces, enabling image generation, vision tasks, TTS, STT, and more, with file handling and optional Claude Desktop mode.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
The mcp-hfspace server connects Claude Desktop to Hugging Face Spaces, enabling image generation, vision tasks, TTS, STT, and more, with file handling and optional Claude Desktop mode.
The mcp-hfspace server offers a convenient way to integrate Hugging Face Spaces with Claude Desktop. It is relatively safe when used with trusted Spaces and a properly configured working directory. However, using untrusted Spaces or failing to configure the working directory can pose security risks.
Performance depends on the Hugging Face Space being used and network latency. ZeroGPU spaces may experience queuing delays.
Using Hugging Face Spaces may incur costs depending on the specific space and usage. Private spaces with dedicated hardware eliminate quota limitations.
{
"mcpServers": {
"mcp-hfspace": {
"command": "npx"
"args": [
"-y",
"@llmindset/mcp-hfspace",
"--work-dir=~/mcp-files/ or x:/temp/mcp-files/",
"--HF_TOKEN=HF_{optional token}"
"Qwen/Qwen2-72B-Instruct",
"black-forest-labs/FLUX.1-schnell",
"space/example/specific-endpint"
(... and so on)
]
}
}
}HF_TOKENImage GenerationGenerates images based on text prompts using Hugging Face Spaces.
Can potentially generate inappropriate content.
Vision ModelAnalyzes images using Hugging Face Spaces, providing insights and descriptions.
Read-only analysis of provided images.
Text-to-SpeechConverts text to speech using Hugging Face Spaces.
Can generate audio with potentially inappropriate content.
Speech-to-TextTranscribes audio into text using Hugging Face Spaces.
Read-only transcription of provided audio.
ChatEngages in conversational interactions using Hugging Face Spaces.
Can generate unpredictable and potentially harmful responses.
Token
hybrid
The `mcp-hfspace` server offers a convenient way to integrate Hugging Face Spaces with Claude Desktop. It is relatively safe when used with trusted Spaces and a properly configured working directory. However, using untrusted Spaces or failing to configure the working directory can pose security risks.
Autonomy is limited by the capabilities of the connected Hugging Face Spaces and the configured working directory.
Production Tip
Monitor Hugging Face Space quotas and consider duplicating spaces for increased availability.
The working directory is used to store downloaded files and provide a location for file uploads.
Supply your Hugging Face token using the `--hf-token` argument or the `HF_TOKEN` environment variable.
In Claude Desktop Mode, images are returned in tool responses, while other files are saved in the working folder, and their file path is returned as a message.
Add the API endpoint to the spacename, e.g., `Qwen/Qwen2.5-72B-Instruct/model_chat`.
Check the working directory for results, as the MCP Server may still capture and save the result even if Claude Desktop times out.
Use the MCP Inspector to get a better look at diagnosing what's going wrong.
Try again after a short period, or set up your own Space for hosting.