HuggingFace SpaceHuggingFace Space

Local

API Integration

Integrate this MCP server into your applications.

Get your API Key

You'll need to login and generate a Smithery API key to connect to this server.

Installation

Install the official MCP SDKs using npm:

bash
npm install @modelcontextprotocol/sdk @smithery/sdk

TypeScript SDK

typescript

import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"

const transport = new StdioClientTransport({
  "command": "npx",
  "args": [
    "-y",
    "@llmindset/mcp-hfspace",
    "--work-dir=./mcp-files",
    "--hf-token=hf_example_token",
    "--desktop-mode=true",
    "evalstate/FLUX.1-schnell"
  ]
})

// Create MCP client
import { Client } from "@modelcontextprotocol/sdk/client/index.js"

const client = new Client({
	name: "Test client",
	version: "1.0.0"
})
await client.connect(transport)

// Use the server tools with your LLM application
const tools = await client.listTools()
console.log(`Available tools: ${tools.map(t => t.name).join(", ")}`)

Configuration Schema

Full JSON Schema for server configuration:

json
{
  "type": "object",
  "properties": {
    "spaces": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of Hugging Face spaces to connect."
    },
    "hfToken": {
      "type": "string",
      "description": "Hugging Face token for accessing private spaces."
    },
    "workDir": {
      "type": "string",
      "description": "Working directory for handling file uploads and downloads."
    },
    "desktopMode": {
      "type": "boolean",
      "default": true,
      "description": "Enable Claude Desktop Mode."
    }
  }
}