Lets agents use Hugging Face Spaces to run open-source image, audio, text and vision models.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add hugging-face-spaces --env SPACES='<SPACES>' -- npx -y @llmindset/mcp-hfspace '--work-dir={{config.WORK_DIR}}' '--hf-token={{config.HF_TOKEN}}' '{{config.SPACES}}'~/.codex/config.toml
[mcp_servers.hugging-face-spaces]
command = "npx"
args = ["-y", "@llmindset/mcp-hfspace", "--work-dir={{config.WORK_DIR}}", "--hf-token={{config.HF_TOKEN}}", "{{config.SPACES}}"]
env = { SPACES = "<SPACES>" }
# codex mcp add hugging-face-spaces --env SPACES='<SPACES>' -- npx -y @llmindset/mcp-hfspace '--work-dir={{config.WORK_DIR}}' '--hf-token={{config.HF_TOKEN}}' '{{config.SPACES}}'~/.cursor/mcp.json
{
"mcpServers": {
"hugging-face-spaces": {
"command": "npx",
"args": [
"-y",
"@llmindset/mcp-hfspace",
"--work-dir={{config.WORK_DIR}}",
"--hf-token={{config.HF_TOKEN}}",
"{{config.SPACES}}"
],
"env": {
"SPACES": "<SPACES>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"hugging-face-spaces": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@llmindset/mcp-hfspace",
"--work-dir={{config.WORK_DIR}}",
"--hf-token={{config.HF_TOKEN}}",
"{{config.SPACES}}"
],
"env": {
"SPACES": "<SPACES>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"hugging-face-spaces": {
"command": "npx",
"args": [
"-y",
"@llmindset/mcp-hfspace",
"--work-dir={{config.WORK_DIR}}",
"--hf-token={{config.HF_TOKEN}}",
"{{config.SPACES}}"
],
"env": {
"SPACES": "<SPACES>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"hugging-face-spaces": {
"command": "npx",
"args": [
"-y",
"@llmindset/mcp-hfspace",
"--work-dir={{config.WORK_DIR}}",
"--hf-token={{config.HF_TOKEN}}",
"{{config.SPACES}}"
],
"env": {
"SPACES": "<SPACES>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"hugging-face-spaces": {
"command": "npx",
"args": [
"-y",
"@llmindset/mcp-hfspace",
"--work-dir={{config.WORK_DIR}}",
"--hf-token={{config.HF_TOKEN}}",
"{{config.SPACES}}"
],
"env": {
"SPACES": "<SPACES>"
}
}
}
}Environment variables
SPACES
Replace the placeholders with your own credentials and keep them out of version control.