# 使用 Homebrew 安装 hf-mcp-server

查看 hf-mcp-server 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:hf-mcp-server
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install hf-mcp-server
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:hf-mcp-server
- **软件包管理器:** Homebrew
- **版本:** 0.4.5
- **来源摘要:** MCP Server for Hugging Face
- **主页:** <https://github.com/evalstate/hf-mcp-server>
- **最后更新:** 2026-08-02T15:38:09Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- hf-mcp-server (别名)
- hf-mcp-server-http (别名)
- hf-mcp-server-http-json (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.4.5
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://formulae.brew.sh/formula/hf-mcp-server>
- <https://github.com/huggingface/hf-mcp-server>
- <https://huggingface.co/blog/building-hf-mcp>
- <https://huggingface.co/docs/hub/agents-mcp>
- <https://raw.githubusercontent.com/huggingface/hf-mcp-server/main/README.md>


## 安全说明

没有找到 hf-mcp-server 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## Combined YAML source

View the package source record on GitHub. [combined/hf-mcp-server.yml](https://github.com/mxcl/pkgdb/blob/main/combined/hf-mcp-server.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph
