ev

evalstate/mcp-hfspace

๐Ÿ“‡ โ˜๏ธ Use HuggingFace Spaces directly from Claude. Use Open Source Image Generation, Chat, Vision tasks and more. Supports Image, Audio and text uploads/downloads.

#HuggingFace#Claude#AI tasks
Publisherevalstate/mcp-hfspace
Submitted date4/19/2025

Overview: mcp-hfspace MCP Server ๐Ÿค—

Title

mcp-hfspace MCP Server โ€“ A seamless integration tool for connecting to Hugging Face Spaces with minimal setup.

How to Use

  1. Installation:

    • Install NodeJS and add the server configuration to claude_desktop_config.json.
    • Use the NPM package @llmindset/mcp-hfspace.
    • Ensure Claude Desktop version 0.78 or higher.
  2. Basic Setup:

    • Specify Hugging Face Spaces in the arguments.
    • Set a working directory for file handling using --work-dir or MCP_HF_WORK_DIR.
    • For private spaces, provide a Hugging Face token via --hf-token or HF_TOKEN.
  3. Running the Server:

    • Multiple instances can be run with different configurations.
    • Supports both Claude Desktop Mode (default) and Base64-encoded resource mode.

Key Features

  • Easy Integration: Connect to Hugging Face Spaces effortlessly.
  • File Handling: Supports upload/download of images, audio, and other files.
  • Multi-Space Support: Use multiple Spaces simultaneously (e.g., image generation, vision models, text-to-speech).
  • Private Space Access: Securely use private Hugging Face Spaces with a token.
  • Claude Desktop Mode: Optimized for Claude Desktop, with images embedded in responses and other files saved locally.
  • Prompt Automation: Auto-generates prompts for Spaces, improving usability.

Use Cases

  1. Image Generation: Compare outputs from different models (e.g., shuttleai/shuttle-3.1-aesthetic).
  2. Vision Models: Analyze images with models like merve/paligemma2-vqav2.
  3. Text-to-Speech & Speech-to-Text: Convert text to audio or transcribe speech using spaces like parler-tts/parler_tts.
  4. Chat & Reasoning: Engage with AI models like Qwen/Qwen2.5-72B-Instruct for complex queries.
  5. Image-to-Image Processing: Annotate and analyze images with tools like microsoft/OmniParser.
  6. Interactive Applications: Use models like DawnC/PawMatchAI for dynamic recommendations.

Recommended Spaces

  • Image Generation: FLUX.1-schnell, shuttleai/shuttle-3.1-aesthetic
  • Chat: Qwen/Qwen2.5-72B-Instruct
  • Audio: parler-tts/parler_tts, hf-audio/whisper-large-v3-turbo
  • Vision: microsoft/OmniParser, merve/paligemma2-vqav2

For more details, visit the introduction page.

Visit More

View All