Best for
- Developers wanting to integrate Hugging Face ecosystem into LLM tools
- AI application builders needing access to models, datasets, and Gradio apps
H
Hf MCP Server
Official
Connect your LLM to the Hugging Face Hub and thousands of Gradio AI Applications.
GitHub source repository ↗
57FMRS · C
Official Hugging Face MCP server, feature-rich, supports multiple clients and transports, suitable for integrating Hugging Face ecosystem.
The official Hugging Face MCP Server provides MCP implementations of Hub API and Search endpoints, along with an MCP server and web application for deploying endpoints. It supports STDIO and stateless Streamable HTTP JSON transports, with tool selection configurable per request via user configuration API and query parameters.
Tools
The tool list has not been reviewed yet.
Setup
- For Claude Desktop or claude.ai, click the link in the README or add 'Hugging Face' from the connectors gallery.
- For Claude Code, run:
claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login(or use a token). - For Gemini CLI, run:
gemini mcp add -t http huggingface https://huggingface.co/mcp?login. - For VSCode, click the link in README or install from the MCP gallery; alternatively configure manually in mcp.json.
- For Cursor, click the install link in README or configure manually.
- You can also run locally via npx or Docker:
npx @llmindset/hf-mcp-serverordocker run --rm -p 3000:3000 ghcr.io/evalstate/hf-mcp-server:latest.
Fit and risk
Not for
- Users not using Hugging Face services
- Scenarios requiring long-lived connections or stateful MCP servers (STDIO does not expose skills)
Required permissions
- Requires a Hugging Face token (HF_TOKEN) for authentication
- HTTP transport requires Authorization: Bearer header
- May access Hugging Face API and Gradio apps
Risks and side effects
- User-supplied tokens may be misused
- Proxy tools or external URLs may introduce security risks
- Local loopback addresses are allowed by default; external access requires allowlist
Troubleshooting
- Check environment variables such as TRANSPORT and DEFAULT_HF_TOKEN
- Ensure network connectivity to Hugging Face services
- Inspect the management dashboard on port 3000 for status and metrics
- For HTTP requests, ensure the Authorization header contains a valid token
- If tool list is empty, check DISABLE_TOOLS or user configuration
Use cases
Interact with the Hugging Face Hub, e.g., search models, datasets, Spaces
Call AI functionalities through Gradio apps
Build AI workflows in MCP-enabled clients
Supported clients
Claude DesktopFull support
Claude CodeFull support
Gemini CLIFull support
VSCodeFull support
CursorFull support