hf-mcp-server packages
About
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.
Details
- Author
- evalstate
- GitHub stars
- 259
- Downloads
- 261
- Categories
- Other
Jump to
- 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
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
hf-mcp-server packagesCommand (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
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hf-mcp-server packages": {
"hf-mcp-server": {
"command": "npx",
"args": [
"@llmindset/hf-mcp-server",
"#",
"Start",
"in",
"STDIO",
"mode"
]
}
}
}
}McpServers
{
"hf-mcp-server": {
"command": "npx",
"args": [
"@llmindset/hf-mcp-server",
"#",
"Start",
"in",
"STDIO",
"mode"
]
}
}MCP Server
The following transports are supported:
- STDIO
- StreamableHTTP
- StreamableHTTP in Stateless JSON Mode (StreamableHTTPJson)
The Web Application and HTTP Transports start by default on Port 3000.
The StreamableHTTP service is available at /mcp. Although though not strictly enforced by the specification this is common convention.
> [!TIP]
> The Web Application allows you to switch tools on and off. For STDIO and StreamableHTTP this will send a ToolListChangedNotification to the MCP Client. In StreamableHTTPJSON mode the tool will not be listed when the client next requests the tool lists.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
