mcp-hfspace MCP Server

This project connects Claude Desktop to Hugging Face Spaces, enabling various functionalities with minimal setup. By adding your spaces to the configuration, you can extend Claude's capabilities.

The package @llmindset/mcp-hfspace is installed via NPM and configured in claude_desktop_config.json. It supports image generation, vision models, and text-to-speech. You can specify Hugging Face spaces in the arguments, and the server automatically finds the appropriate endpoint. A working directory is recommended for file handling, configurable via --work-dir or MCP_HF_WORK_DIR. Private spaces are supported using a Hugging Face token via --hf-token or HF_TOKEN.

The server operates in Claude Desktop Mode by default, returning images in tool responses and saving other files in the working directory. It supports file uploads/downloads, URL inputs, and an "Available Resources" prompt. Examples include image generation, vision model queries, text-to-speech, speech-to-text, and image-to-image tasks. Specific API endpoints can be specified. Claude Desktop Mode can be disabled to return content as Base64 encoded resources.