hf-mcp-server packages

@evalstate

About hf-mcp-server packages

Hugging Face MCP Server

Config

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

{
  "mcpServers": {
    "hf-mcp-server": {
      "command": "npx",
      "args": [
        "@llmindset/hf-mcp-server",
        "#",
        "Start",
        "in",
        "STDIO",
        "mode"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is hf-mcp-server?

hf-mcp-server is the official Hugging Face MCP server that connects LLMs to the Hugging Face Hub and thousands of Gradio AI applications. It provides MCP implementations of Hub API and search endpoints, enabling AI assistants to interact with Hugging Face resources.

How to use hf-mcp-server?

Install via one-click links for Claude Desktop/Web, VSCode, or Cursor, or use CLI commands for Claude Code (claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login) and Gemini CLI (gemini mcp add -t http huggingface https://huggingface.co/mcp?login). Run locally with npx @llmindset/hf-mcp-server (STDIO), npx @llmindset/hf-mcp-server-http (StreamableHTTP), or via Docker. Configure tokens via environment variables like DEFAULT_HF_TOKEN or HF_TOKEN.

Key features of hf-mcp-server

Supports STDIO, StreamableHTTP, and StreamableHTTP JSON transports
Web management interface on port 3000 for toggling tools
Proxy tools loaded from CSV-defined MCP endpoints
Skills directory support for shared Hugging Face skill catalogs
Stateful connection management with configurable timeouts
Environment variable configuration for timeouts, transport, and tool options

Use cases of hf-mcp-server

Connect an LLM to search and retrieve models, datasets, and Spaces from the Hugging Face Hub
Run Gradio AI applications directly through MCP tools
Build custom AI assistants that can interact with Hugging Face APIs
Deploy a local MCP server with proxy tools for internal workflows

FAQ from hf-mcp-server

What transports does hf-mcp-server support?

STDIO (stdin/stdout), StreamableHTTP (stateful HTTP with SSE), and StreamableHTTP JSON (stateless JSON-RPC mode).

How do I run hf-mcp-server locally?

Use npx @llmindset/hf-mcp-server for STDIO, npx @llmindset/hf-mcp-server-http for StreamableHTTP, or pull and run the Docker image from ghcr.io/evalstate/hf-mcp-server:latest.

How do I authenticate with the server?

Pass a Hugging Face token via the Authorization: Bearer header when configuring an MCP client, or set the DEFAULT_HF_TOKEN environment variable for development/STDIO use.

What environment variables control the server?

Key variables: TRANSPORT (transport mode), DEFAULT_HF_TOKEN, HF_TOKEN (STDIO fallback), HF_API_TIMEOUT, ALLOW_INTERNAL_ADDRESS_HOSTS, MCP_STRICT_COMPLIANCE, AUTHENTICATE_TOOL, SEARCH_ENABLES_FETCH, PROXY_TOOLS_CSV, GRADIO_SKIP_INITIALIZE, and HF_SKILLS_DIR.

Where can I manage tools after installation?

Navigate to https://huggingface.co/settings/mcp to configure your tools and Spaces. The local web dashboard on port 3000 also allows toggling tools.

Frequently asked questions

What transports does hf-mcp-server support?

STDIO (stdin/stdout), StreamableHTTP (stateful HTTP with SSE), and StreamableHTTP JSON (stateless JSON-RPC mode).

How do I run hf-mcp-server locally?

Use `npx @llmindset/hf-mcp-server` for STDIO, `npx @llmindset/hf-mcp-server-http` for StreamableHTTP, or pull and run the Docker image from `ghcr.io/evalstate/hf-mcp-server:latest`.

How do I authenticate with the server?

Pass a Hugging Face token via the `Authorization: Bearer` header when configuring an MCP client, or set the `DEFAULT_HF_TOKEN` environment variable for development/STDIO use.

What environment variables control the server?

Key variables: `TRANSPORT` (transport mode), `DEFAULT_HF_TOKEN`, `HF_TOKEN` (STDIO fallback), `HF_API_TIMEOUT`, `ALLOW_INTERNAL_ADDRESS_HOSTS`, `MCP_STRICT_COMPLIANCE`, `AUTHENTICATE_TOOL`, `SEARCH_ENABLES_FETCH`, `PROXY_TOOLS_CSV`, `GRADIO_SKIP_INITIALIZE`, and `HF_SKILLS_DIR`.

Where can I manage tools after installation?

Navigate to https://huggingface.co/settings/mcp to configure your tools and Spaces. The local web dashboard on port 3000 also allows toggling tools.

Comments

Basic information

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K