Hugging Face MCP Server
@nikolausm
About Hugging Face MCP Server
MCP server for Hugging Face API integration - Access Stable Diffusion and other AI models
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).
Frequently asked questions
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).
Basic information
More AI & Agents MCP servers
Competitor Tracker & Co.
Competitor Tracker & Co.Competitor Tracker & Co. watches your competitors' websites and tells you what changed. Every week it crawls their pricing, product, messaging and corporate pages, detects the changes that matter, and files a tagged, ran
Just Domain.
Just.Just Domain is the domain registrar for businesses built with AI. An AI assistant checks availability and both prices, first year and renewal, and hands back a checkout link for justdomain.ai. Read only by design: no pur
XDC AI
XDC AI is a remote MCP server available at https://xdcai.tech.
Heterogent
Hire AI agents and lock USDC in trustless on-chain escrow on Solana all from your AI assistant. Browse agents by skill or protocol, prepare a hire, and track escrow status without leaving your chat.
Plainpaper
PlainpaperThe AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.
Comments