A
securityA
licenseA
qualityUse HuggingFace Spaces directly from Claude. Use Open Source Image Generation, Chat, Vision tasks and more. Supports Image, Audio and text uploads/downloads.
Last updated -
3
123
362
MIT License
MCP HuggingFetch enables high-speed downloading and management of HuggingFace models at 3-5x faster speeds through concurrent downloads, resume support, and intelligent retries.
Core Features:
Download Models: Fetch HuggingFace models with specific file selection, revision control, and pattern-based filtering
List Repository Files: Browse contents including file paths, sizes, and types with sorting options (by size, name, or type)
Advanced Filtering: Include/exclude files using glob patterns (e.g.,
*.json,*.safetensors) and filter by sub-pathsFlexible Configuration: Choose custom download directories, specific Git branches/tags/commits, and force redownload options
Reliability Features: Resume interrupted downloads and automatic retry for failed transfers
Authentication: Access private repositories using HuggingFace tokens via environment variables
Enables downloading and managing models from HuggingFace repositories, with support for file filtering, size limits, and selective downloads
MCP HuggingFace Fast Download Tool
⚡ High-speed HuggingFace model downloads with concurrent downloading, resume support, and intelligent retry - 3-5x faster than traditional methods. Supports Claude Desktop, Claude Code, Cursor, VS Code, and other clients.
中文版 | 日本語 | Français | Deutsch
📋 Quick Setup
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"huggingfetch": {
"command": "npx",
"args": ["-y", "mcp-huggingfetch@latest"],
"env": {
"HUGGINGFACE_TOKEN": "your_token_here"
}
}
}
}
Claude Code
Add to .claude/claude_config.json:
{
"mcpServers": {
"huggingfetch": {
"command": "npx",
"args": ["-y", "mcp-huggingfetch@latest"],
"env": {
"HUGGINGFACE_TOKEN": "your_token_here"
}
}
}
}
Cursor / VS Code (Continue Extension)
Add to config.json:
{
"mcp": [
{
"name": "huggingfetch",
"command": "npx",
"args": ["-y", "mcp-huggingfetch@latest"],
"env": {
"HUGGINGFACE_TOKEN": "your_token_here"
}
}
]
}
🔑 Get HuggingFace Token
Visit HuggingFace Settings
Create a new Access Token
Copy the token to
HUGGINGFACE_TOKENin the above configuration
🛠 Usage
After configuration, use the following features directly in conversations:
📋 List Files
View and filter repository files:
List JSON files in the 2Noise/ChatTTS repository
🔍 Explore Repository
Understand repository structure:
Explore the directory structure of microsoft/DialoGPT-medium
🔎 Search Files
Find specific files by name:
Search for config files in openai/whisper-large-v3
📥 Download Models
Selectively download required files:
Please download the ChatTTS model to ./models directory
Download microsoft/DialoGPT-medium model, only .bin files
Download openai/whisper-large-v3 model, exclude test files
📝 Available Tools
File Listing (list_huggingface_files)
List and filter repository files with pattern matching and sorting.
Parameter | Type | Description | Default |
| string | HuggingFace repository ID | - |
| string | Git branch/tag |
|
| string | File filter pattern (glob) | - |
| string | Exclusion pattern | - |
| number | Maximum files to return |
|
| string | Sort by:
,
,
|
|
Repository Explorer (explore_huggingface_repo)
Explore repository structure and get hierarchical file tree.
Parameter | Type | Description | Default |
| string | HuggingFace repository ID | - |
| string | Git branch/tag |
|
| number | Maximum scan depth |
|
| boolean | Generate ASCII tree view |
|
File Search (search_huggingface_files)
Search files by name or pattern within repository.
Parameter | Type | Description | Default |
| string | HuggingFace repository ID | - |
| string | Search keyword or pattern | - |
| string | Git branch/tag |
|
| number | Maximum results to return |
|
Download Tool Options (download_huggingface_model)
Parameter | Type | Description | Example |
| string | HuggingFace repository ID |
|
| string | Download directory |
|
| array | Specific file list |
|
| string/array | Include patterns |
or
|
| string/array | Exclude patterns |
or
|
| string | Git branch/tag |
,
|
| boolean | Force re-download |
,
|
🔧 Environment Variables
Variable | Required | Default | Description |
| ✅ | - | HuggingFace access token |
| ❌ |
| Default download directory |
| ❌ |
| Cache directory |
| ❌ |
| Log level (
,
,
,
) |
❓ FAQ
Q: Token authentication failed, what should I do?
A: Check if HUGGINGFACE_TOKEN is correctly set, ensure the token is valid and has sufficient permissions.
Q: Download speed is slow, what can I do?
A: The tool supports resume downloads and concurrent downloading. Network issues may cause slow speeds, automatic retry will occur.
Q: How to download private models?
A: Ensure your HuggingFace account has access permissions and use a valid token.
Q: What file formats are supported?
A: All file formats on HuggingFace are supported, including .pt, .bin, .safetensors, .json, .txt, etc.
🏗 Development
Prerequisites
Node.js 18+
npm or yarn
Installation
git clone https://github.com/freefish1218/mcp-huggingfetch.git
cd mcp-huggingfetch
npm install
Development Commands
npm run dev # Run with file watching
npm start # Run the MCP server
npm run test:basic # Run basic functionality tests
npm test # Run Jest unit tests
npm run lint # Check code style
npm run lint:fix # Auto-fix linting issues
Release Commands
npm run release:patch # Release patch version (1.0.0 -> 1.0.1)
npm run release:minor # Release minor version (1.0.0 -> 1.1.0)
npm run release:major # Release major version (1.0.0 -> 2.0.0)
The release scripts will automatically:
Run tests and linting
Update version number
Create git tag
Push to GitHub
Publish to npm
For more details, see Release Guide
Building
npm run build # Build single binary
npm run build:all # Build for all platforms (Linux, macOS, Windows)
📄 License
MIT License - see LICENSE file for details.
📖 Links
GitHub: freefish1218/mcp-huggingfetch
Issues: Report Issues
NPM: mcp-huggingfetch
🤝 Contributing
Contributions are welcome! Please see CONTRIBUTING.md for guidelines.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables users to download HuggingFace models through natural language requests with support for file filtering, size limits, and custom download directories. Supports various AI development environments including Claude Desktop, VS Code, and Cursor.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides Claude and other LLMs with read-only access to Hugging Face Hub APIs, enabling interaction with models, datasets, spaces, papers, and collections through natural language.Last updated -1062MIT License
- AsecurityAlicenseAqualityConnects Claude Desktop to Hugging Face Spaces with minimal setup, enabling capabilities like image generation, vision tasks, text-to-speech, and chat with AI models.Last updated -3123MIT License
- -securityAlicense-qualityA Model Context Protocol server that allows Claude and other MCP-compatible AI assistants to interact with the Hugging Face ecosystem, enabling repository management, file operations, search, and collections management through natural language.