mcp-hfspace MCP Server 🤗

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

Catalog onlyCatalog onlySTDIO

Overview

mcp-hfspace is a server designed to facilitate the use of HuggingFace spaces with minimal configuration, particularly in Claude Desktop mode for generating images and handling files.

To use mcp-hfspace, you can either install it via NPX with the command npx @llmindset/mcp-hfspace or download and build it from the provided GitHub repository. Configuration involves adding your desired HuggingFace spaces and running the server.

Seamless integration with HuggingFace spaces - Supports file handling in Claude Desktop mode - Multiple server instances and configurations for diverse use cases - Supports private HuggingFace spaces with authentication tokens

Generating and downloading images using AI models.
Uploading images for analysis and returning results.
Transcribing audio files and generating text outputs.
Managing multiple HuggingFace spaces for varied tasks.

Add to your AI client

Use these steps to connect mcp-hfspace MCP Server 🤗 in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-hfspace-evalstate": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-hfspace-evalstate"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

Developer tools