mcp-hfspace MCP Server 🤗
@evalstate
About mcp-hfspace MCP Server 🤗
MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.
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.
Frequently asked questions
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.
Basic information
More AI & Agents MCP servers
Open Multi-Agent Canvas
CopilotKitThe open-source multi-agent chat interface that lets you manage multiple agents in one dynamic conversation and add MCP servers for deep research
Shell and Coding agent for Claude and other mcp clients
rusiaamanShell and coding agent on mcp clients
Solon Ai
opensolonJava AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.
Sequential Thinking Multi-Agent System (MAS)
FradSerAn advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.
Lumify Sports Intelligence
LumifyAgent-ready sports intelligence API: live scores, odds, line movement, public betting splits, and explainable bet confidence — via 16 MCP tools at https://lumify.ai/mcp. Get a free key instantly — no signup, email, or ca
Comments