Design Engineer Logo
Visit Repo
Open Graph preview

MCP HFspace

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

Site favicon
🛠️ Development

Overview

mcp-hfspace

Description: Server for seamless integration with HuggingFace spaces, optimized for Claude Desktop usage.

Category: AI Model Integration

Overview: A server implementation that enables easy connection to HuggingFace Spaces with minimal configuration. Key features include:

  • Automatic endpoint detection and configuration
  • Claude Desktop mode support with integrated file handling
  • Support for private spaces via HuggingFace tokens
  • Flexible working directory management
  • Handles various AI tasks: image generation, vision, speech, chat

Installation:

Using mcp-get:

npx @michaellatman/mcp-get@latest install @llmindset/mcp-hfspace

Using Smithery:

npx @smithery/cli install @llmindset/mcp-hfspace --client claude

Configuration:

Basic claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-hfspace": {
      "command": "npx",
      "args": [
        "-y",
        "@llmindset/mcp-hfspace",
        "--work-dir=~/mcp-files/",
        "--HF_TOKEN=HF_YOUR_TOKEN",
        "space1/model",
        "space2/model"
      ]
    }
  }
}

Key Features:

  • File handling in desktop mode
  • URL content support
  • Audio processing capabilities
  • Vision model integration
  • Image generation support
  • Chat model integration

Important Notes:

  • Desktop mode enabled by default (can be disabled)
  • 60s timeout limit in Claude Desktop
  • Working directory recommended for file handling
  • ZeroGPU quota limitations may apply