mcp-hfspace MCP Server 🤗
@evalstate
About mcp-hfspace MCP Server 🤗
MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-hfspace": {
"command": "npx",
"args": [
"-y",
"@llmindset/mcp-hfspace"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is mcp-hfspace?
mcp-hfspace is an MCP server that connects Claude Desktop and other MCP clients to Hugging Face Spaces, enabling access to thousands of AI models and applications. It is designed for developers and researchers who want to integrate Hugging Face’s AI capabilities into their workflows with minimal setup.
How to use mcp-hfspace?
Install NodeJS, then add the server to your claude_desktop_config.json with the command npx -y @llmindset/mcp-hfspace. Supply a list of Hugging Face Space names as arguments. Optionally set a working directory via --work-dir or MCP_HF_WORK_DIR, and supply a Hugging Face token for private spaces via --hf-token or HF_TOKEN.
Key features of mcp-hfspace
- Connects to any Hugging Face Space automatically
- Default space: black-forest-labs/FLUX.1-schnell for image generation
- Supports file upload, download, and URL inputs
- Private spaces supported with Hugging Face token
- Multiple server instances for different tokens/working directories
- Claude Desktop Mode with embedded image returns
Use cases of mcp-hfspace
- Generate and compare images using different models (e.g., FLUX.1-schnell vs shuttle-3.1-aesthetic)
- Use vision models to analyze images from files or URLs
- Convert text to speech or transcribe audio with speech-to-text spaces
- Perform image-to-image tasks like background removal and annotation
- Run chat models like Qwen for reasoning tasks
FAQ from mcp-hfspace
What has replaced this project?
The 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 with SSE support.
What are the runtime requirements?
Requires NodeJS and Claude Desktop 0.78 or greater. The server is installed via npm as @llmindset/mcp-hfspace.
How does file handling work?
In Claude Desktop Mode, images are returned in tool responses; other files are saved in the working directory with their path returned. URLs can also be supplied as inputs.
What limitations exist?
Endpoints with unnamed parameters are unsupported. Some complex Python types may not fully translate to MCP formats. Claude Desktop may timeout on long jobs (hard 60s limit). Check the working directory for results produced after timeout.
How do I configure private spaces and tokens?
Supply a Hugging Face token via --hf-token=hf_... or the HF_TOKEN environment variable. Private spaces are supported, and the token is used to download generated content.
More AI & Agents MCP servers
Mcp Agent
lastmile-aiBuild effective agents using Model Context Protocol and simple workflow patterns
Shell and Coding agent for Claude and other mcp clients
rusiaamanShell and coding agent on mcp clients
1Panel
1Panel-dev🔥 1Panel is a modern, open-source VPS control panel — and the only one with native AI agent support. Run Ollama models, deploy OpenClaw agents, and manage your entire server stack from one clean web interface.
Perplexity MCP Server
DaInfernalCoderA Model Context Protocol (MCP) server for research and documentation assistance using Perplexity AI. Won 1st @ Cline Hackathon
MCP-LLM Bridge
patruffBridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools
Comments