Hugging Face MCP Server

Name: Hugging Face MCP Server
Author: nikolausm

@nikolausm

Repository

About Hugging Face MCP Server

MCP server for Hugging Face API integration - Access Stable Diffusion and other AI models

#huggingface #mcp-server #ai-image-generation

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "huggingface": {
      "command": "node",
      "args": [
        "/path/to/huggingface-mcp-server/index.js"
      ],
      "env": {
        "HUGGINGFACE_TOKEN": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Hugging Face MCP Server?

An MCP (Model Context Protocol) server that provides access to Hugging Face's AI image generation models, including Stable Diffusion. It allows users to generate images from text prompts using multiple models, check API status, and manage tokens—all through the MCP interface.

How to use Hugging Face MCP Server?

Clone the repository and install dependencies with npm install. Obtain a free Hugging Face API token from your settings page and set it as the HUGGINGFACE_TOKEN environment variable. Then add the server to your Claude Desktop configuration (or any MCP client) pointing to the server's index.js file. Use the provided tools: generate_image, list_models, and check_status.

Key features of Hugging Face MCP Server

Generate images using multiple Stable Diffusion models
Support for negative prompts and guidance scale
Save images locally or return as base64
Check API status and token validity
Free tier available with rate limits
Model selection from SD2.1 to SDXL and more

Use cases of Hugging Face MCP Server

Creating children's book illustrations with specific art styles
Generating educational diagrams (e.g., anatomy posters)
Rapid prototyping of fantasy or anime-style artwork
Producing high-quality general-purpose images for content creation

FAQ from Hugging Face MCP Server

What models are available?

Stable Diffusion 2.1, Stable Diffusion XL, OpenJourney, Dreamlike Diffusion, and Anything v5 (anime/manga style).

Is there a free tier?

Yes, the free tier is rate-limited to approximately 10–20 requests per minute. Some models may experience queue times. For production use, upgrading to a paid plan is recommended.

How do I get a Hugging Face API token?

Go to https://huggingface.co/settings/tokens, create a new token (free), and copy it. Set it as the HUGGINGFACE_TOKEN environment variable.

How do I configure this server in Claude Desktop?

Add a mcpServers entry to ~/Library/Application Support/Claude/claude_desktop_config.json with command: "node", args: ["/path/to/index.js"], and env: { HUGGINGFACE_TOKEN: "your_token" }.

What parameters can I use for image generation?

prompt (required), model (defaults to sd-2.1), negative_prompt, guidance_scale (higher values follow prompt more closely), and save_path (to save locally instead of base64).