MCP.so
Sign In

🤗 HuggingMCP - Hugging Face Model Context Protocol Server

@ProCreations-Official

Repository

About 🤗 HuggingMCP - Hugging Face Model Context Protocol Server

Model Context Protocol (MCP) server for HuggingFace integration - lets Claude create, manage, and interact with HuggingFace spaces, models, datasets, and collections

Config

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

{
  "mcpServers": {
    "HuggingMCP": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

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 HuggingMCP?

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. It enables natural language management of models, datasets, files, pull requests, and collections.

How to use HuggingMCP?

Install the server in a Python 3.10+ environment with uv or pip, then configure your Hugging Face token and permission settings in the Claude Desktop configuration file. After restarting Claude, you can use natural language commands to perform operations like creating repositories, editing files, searching models, and managing pull requests.

Key features of HuggingMCP

  • 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

Use cases of HuggingMCP

  • Use Claude to create a new model repository with a custom README
  • Edit a training script by replacing a specific line of code
  • Search for the top 10 most downloaded text classification models
  • Create a pull request to improve a model card on a public repo
  • Organize favorite models and datasets into a personal collection

FAQ from HuggingMCP

What permissions are available?

Read-only, write-only, and admin mode are set via environment variables (HF_READ_ONLY, HF_WRITE_ONLY, HF_ADMIN_MODE). Default mode provides full read/write access.

What Python version is required?

Python 3.10 or higher is required.

How do I enable admin mode for deleting repositories?

Set the HF_ADMIN_MODE environment variable to "true" in the Claude Desktop configuration.

How can I test that the server is connected properly?

Look for the 🔨 hammer icon in Claude Desktop or use the hf_test tool to verify the connection.

Where can I find debug logs if something goes wrong?

On macOS: ~/Library/Logs/Claude/mcp.log; on Windows: %APPDATA%/Claude/Logs/mcp.log. You can also enable verbose logging in main.py.

Frequently asked questions

What permissions are available?

Read-only, write-only, and admin mode are set via environment variables (`HF_READ_ONLY`, `HF_WRITE_ONLY`, `HF_ADMIN_MODE`). Default mode provides full read/write access.

What Python version is required?

Python 3.10 or higher is required.

How do I enable admin mode for deleting repositories?

Set the `HF_ADMIN_MODE` environment variable to `"true"` in the Claude Desktop configuration.

How can I test that the server is connected properly?

Look for the 🔨 hammer icon in Claude Desktop or use the `hf_test` tool to verify the connection.

Where can I find debug logs if something goes wrong?

On macOS: `~/Library/Logs/Claude/mcp.log`; on Windows: `%APPDATA%/Claude/Logs/mcp.log`. You can also enable verbose logging in `main.py`.

Comments

Basic information

Category

AI & Agents

License

MIT license

Transports

stdio

Author

ProCreations-Official

More AI & Agents MCP servers

L

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

1

Agentery

ntlgnc

Free MCP for live and historical pricing for 13,000+ agents and MCPs. Never knowingly pay too much... or charge too little. Know the going rate. https://agentery.com.

bsv.cx

Andy Rowe

Timestamp and verify evidence on-chain. Let your agent prove what it saw and when. bsv.cx gives an AI agent verifiable memory. Timestamp a hash of any output, archive a web page as it looked, or fetch a URL with a recei

Sphere

dtajitdinov-aris

Open marketplace where AI agents register, publish services, and transact via escrowed contracts. Live at starsphera.com.

F

fhirHydrant

faulkj

Open-source Node.js FHIR MCP server with SMART Backend Services, metadata-aware search/CRUD tools, compact responses, FHIRPath filtering, safe pagination, audit events, and terminology lookup.

14