🤗 HuggingMCP - Hugging Face Model Context Protocol Server
About
Model Context Protocol (MCP) server for HuggingFace integration - lets Claude create, manage, and interact with HuggingFace spaces, models, datasets, and collections
Details
- License
- MIT license
Explore
- Create, delete, and manage Hugging Face repositories
- Create and manage pull requests with file uploads
- Read, write, edit, and delete files on repositories
- Search models, datasets, and spaces with filters
- Organize repositories into collections
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🤗 HuggingMCP - Hugging Face Model Context Protocol ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Python 3.10+ installed on your system
- Claude Desktop application (Download here)
- Hugging Face account and access token (Get token here)
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv add "mcp[cli]" huggingface_hub
Once connected, you can use natural language to interact with Hugging Face:
- hf_test - Test server functionality and connection
- get_hf_config - Get current configuration and capabilities
- hf_whoami - Get current authenticated user info
| Variable | Default | Description |
|----------|---------|-------------|
| HF_TOKEN | None | Your Hugging Face access token (required) |
| HF_READ_ONLY | false | Enable read-only mode |
| HF_WRITE_ONLY | false | Enable write-only mode |
| HF_ADMIN_MODE | false | Enable admin operations (repository deletion) |
| HF_MAX_FILE_SIZE | 100000000 | Maximum file size in bytes (100MB default) |
Basic Configuration:
{
"mcpServers": {
"huggingmcp": {
"command": "python",
"args": ["/path/to/main.py"],
"env": {
"HF_TOKEN": "your-hf-token-here"
}
}
}
}
Advanced Configuration:
{
"mcpServers": {
"huggingmcp": {
"command": "uv",
"args": [
"--directory", "/path/to/huggingmcp",
"run", "main.py"
],
"env": {
"HF_TOKEN": "your-hf-token-here",
"HF_ADMIN_MODE": "true",
"HF_READ_ONLY": "false",
"HF_WRITE_ONLY": "false",
"HF_MAX_FILE_SIZE": "100000000"
}
}
}
}
``
1. Check the logs in Claude Desktop's MCP log files
2. Verify configuration using the
get_hf_config tool
3. Test authentication with hf_whoami
4. Test basic functionality with 5. Start simple with read operations before trying writes
HuggingMCP exposes the following tools to Claude:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83e\udd17 huggingmcp - hugging face model context protocol server": {
"HuggingMCP": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"HuggingMCP": {
"command": "uv",
"args": [
"venv"
]
}
}Give Claude superpowers with Hugging Face! 🚀
HuggingMCP is a comprehensive Model Context Protocol (MCP) server that allows Claude and other MCP-compatible AI assistants to interact seamlessly with the Hugging Face ecosystem. Create models, manage datasets, edit files, organize collections, and much more - all through natural language!
✨ Features
🏗️ Repository Management
- Create repositories (models, datasets, spaces) with custom settings - Delete repositories (admin mode required) - Get detailed repository information and metadata - List repository files and directory structures🔀 Pull Requests & Collaboration
- Create pull requests on any public/private HuggingFace repository - Upload files with PR - make changes and create PRs in one step - Commit with PR - bundle multiple file changes into a single PR - List pull requests with filters (status, author, repo type) - Get PR details including comments, conflicts, and git references - Draft mode support - PRs start in draft for safe collaboration📝 Advanced File Operations
- Read files from any Hugging Face repository (public/private) - Write/upload files with custom content - Precise file editing with exact text replacement (old_text → new_text) - Delete files from repositories - Binary file support for non-text files🔍 Search & Discovery
- Search models with filters (author, tags, popularity) - Search datasets across all of Hugging Face - Search Spaces and demo applications - Advanced filtering by downloads, likes, creation date - Comprehensive metadata for all results📚 Collections Management
- Create collections to organize repositories - Add items to collections (models, datasets, spaces, papers) - Manage collection metadata and descriptions - Get collection information and item lists🔒 Security & Permissions
- Token-based authentication with Hugging Face - Permission controls: read-only, write-only, admin modes - File size limits to prevent abuse - Comprehensive error handling🚀 Quick Start
Prerequisites
- Python 3.10+ installed on your system
- Claude Desktop application (Download here)
- Hugging Face account and access token (Get token here)
Installation
1. Create a project directory:
mkdir huggingmcp && cd huggingmcp
2. Save the main.py file from the artifact in your project directory
3. Install dependencies:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
