mcp-hfspace MCP Server 🤗

Name: mcp-hfspace MCP Server 🤗
Author: evalstate

@evalstate

代码仓库主页

关于 mcp-hfspace MCP Server 🤗

MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.

基本信息

分类

AI 与智能体

许可证

MIT

运行时

node

传输方式

stdio

发布者

evalstate

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-hfspace": {
      "command": "npx",
      "args": [
        "-y",
        "@llmindset/mcp-hfspace"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.

AI 与智能体分类下的更多 MCP 服务器

MCP Manager for Claude Desktop

zueai

simple web ui to manage mcp (model context protocol) servers in the claude app

290

Unreal Engine Generative AI Support Plugin

prajwalshettydev

Unreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti

622