# Install hf-mcp-server with Homebrew MCP Server for Hugging Face. Version 0.3.26 via Homebrew; verified 2026-07-04. ## Install ```sh sudo av install brew:hf-mcp-server ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install hf-mcp-server ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:hf-mcp-server - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.3.26 - **Source summary:** MCP Server for Hugging Face - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-04T15:13:20Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - hf-mcp-server (cli) - hf-mcp-server-http (cli) - hf-mcp-server-http-json (cli) - hf-mcp-server (alias) - hf-mcp-server-http (alias) - hf-mcp-server-http-json (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.3.26 - Package-manager updated: 2026-07-04 - Local data: ok - Upstream repository: https://github.com/evalstate/hf-mcp-server - info: No cached GitHub release or tag data was available. ## Project history and usage The Hugging Face MCP Server is Hugging Face's official bridge between MCP-compatible assistants and the Hugging Face Hub. It packages Hub search, documentation search, repository metadata, Jobs, and Gradio/Spaces tools behind Model Context Protocol transports, making the Hub available from editors, chat clients, and command-line agent workflows. ### Project history Hugging Face introduced the server after the Model Context Protocol began spreading as a common way for AI assistants to call external tools. In the project's own account of the work, Hugging Face chose MCP because exposing Hub models, datasets, Spaces, papers, and documentation to assistants was a natural extension of the Hub. The open-source repository packages both MCP implementations of Hub API/search endpoints and an app for deploying endpoints, with local STDIO, Streamable HTTP, and JSON-mode HTTP transports. The server also grew out of the Gradio and Spaces ecosystem. Hugging Face's Hub documentation describes the server as a way to search and explore Hub resources and to run community tools exposed by MCP-compatible Gradio apps hosted on Spaces. That makes the package less a single-purpose daemon than a connector layer for the broader Hugging Face agent stack. ### Adoption history The project was designed for integration rather than manual protocol work. Its README gives installation paths for Claude Desktop, Claude Code, Gemini CLI, VS Code, Cursor, local npx execution, and Docker. Hugging Face's documentation similarly routes users through the MCP settings page, where client-specific configuration can be generated while logged in. In package-manager terms, the Homebrew formula turns what began as an agent connector into a normal local tool with `hf-mcp-server`, `hf-mcp-server-http`, and JSON transport executables. That matters for developers who want repeatable setup outside npm-oriented agent templates. ### How it is used Typical use is either remote, by pointing a client at `https://huggingface.co/mcp`, or local, by running the packaged server in STDIO or Streamable HTTP mode. Authenticated configurations pass a Hugging Face token or complete the Hugging Face login flow so assistants can use selected tools and Spaces. The server is used when an assistant needs to search models, datasets, Spaces, papers, or Hugging Face documentation, inspect Hub repository details, or call Gradio tools exposed through MCP. The management web application can enable or disable tools and notify clients when the tool list changes. ### Why package nerds care For package nerds, `hf-mcp-server` is a compact example of the agent-tooling wave becoming ordinary Unix software: multiple transports, local and hosted modes, Docker images, npm packages, and a Homebrew formula all point at the same connector. It is also a useful case study in how a cloud ML platform exposes itself to editor agents without requiring every client to learn the Hub API directly. ### Timeline - 2024: MCP launched and began iterating through protocol revisions that influenced Hugging Face's server transport choices. - 2025-07-10: Hugging Face published its article on building the official MCP server. - 2025: Hugging Face documented the Hub MCP Server for MCP-compatible clients including editors, chat clients, and CLIs. - Package-manager era: Homebrew packages the server executables for local use as `hf-mcp-server`. ### Related projects - The server is related to the Hugging Face Hub, `huggingface_hub`, Gradio Spaces MCP servers, the MCP protocol SDKs, and editor or chat clients such as Claude Code, Gemini CLI, VS Code, Cursor, Zed, ChatGPT, and Claude Desktop. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for hf-mcp-server. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** hf-mcp-server - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [text-embeddings-inference](https://www.automicvault.com/pkg/brew/text-embeddings-inference/) - Shares av.db curated category or tags: cli, developer-tools, hugging-face, machine-learning, server. - [hf](https://www.automicvault.com/pkg/brew/hf/) - Shares av.db curated category or tags: cli, developer-tools, hugging-face, machine-learning. - [crf++](https://www.automicvault.com/pkg/brew/crf/) - Shares av.db curated category or tags: cli, developer-tools, machine-learning. - [dvc](https://www.automicvault.com/pkg/brew/dvc/) - Shares av.db curated category or tags: cli, developer-tools, machine-learning. - [llama.cpp](https://www.automicvault.com/pkg/brew/llama-cpp/) - Shares av.db curated category or tags: cli, developer-tools, machine-learning. - [mlx](https://www.automicvault.com/pkg/brew/mlx/) - Shares av.db curated category or tags: cli, developer-tools, machine-learning. - [mlx-lm](https://www.automicvault.com/pkg/brew/mlx-lm/) - Shares av.db curated category or tags: cli, developer-tools, machine-learning. - [pytorch](https://www.automicvault.com/pkg/brew/pytorch/) - Shares av.db curated category or tags: cli, developer-tools, machine-learning. ## Combined YAML source View the package source record on GitHub. [combined/hf-mcp-server.yml](https://github.com/automic-vault/db/blob/main/combined/hf-mcp-server.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph