← 返回目录

Hf MCP Server

官方

连接你的 LLM 与 Hugging Face Hub 及数千个 Gradio AI 应用。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 158 / 438
Stars: ★ 303 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Docker · 远程托管（无需本地环境）
凭据: 可选 API Key
许可证: MIT
最近提交: 6 天前

57FMRS · C

Hugging Face 官方 MCP 服务器，功能丰富，支持多种客户端和传输方式，适合集成 Hugging Face 生态。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

11/20

维护活跃度

10/20

文档质量

12/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 证据：README 说明了 stdio 与 StreamableHTTP/JSON 两种传输、本地 npx/docker 启动方式、多个环境变量（超时、主机白名单、禁用工具等），这些使正常路径看起来可运行。扣分：没有提供实际工具清单，没有可验证的 CI 工作流或测试文件，无法确认 init + tools/list 握手与真实工具行为一致；错误路径和边界情况也缺少证据。
安全与权限 11/20: 证据：README 要求 HTTP 传输使用 Authorization Bearer token，本地 stdio 可用 DEFAULT_HF_TOKEN/HF_TOKEN；还提到出站检查、ALLOW_INTERNAL_ADDRESS_HOSTS、DISABLE_TOOLS 和代理工具来源限制，说明有安全考虑。扣分：未说明 token 的最小权限/只读范围、Gradio 应用调用可能产生的副作用是否需确认、代理工具来源的完整性验证，也没有安全审计或漏洞报告通道；这些关键点缺失使安全评分无法更高。
维护活跃度 10/20: 证据：仓库属于 Hugging Face 组织，MIT 许可证，未归档，README 显示持续使用 pnpm 10.12.3 和 Docker 构建。扣分：仅凭 README 和元数据无法看到提交频率、发版节奏、依赖更新记录或 issue 响应情况；13 个 open issues 没有处理证据，因此按“活跃但有治理缺口”给分。
文档质量 12/20: 证据：README 覆盖 Claude、Gemini、VSCode、Cursor 的安装，以及本地运行、Docker、环境变量、代理工具和 Skills 说明，结构和示例较完整。扣分：没有列出该 MCP 服务器实际提供的工具及其参数，也缺少限制、费用、故障排除和已知问题说明；用户仍需依赖外部配置或猜测能力边界。
安装易用性 14/20: 证据：README 给出了多种主流客户端的配置示例（含 URL 和 Header 片段），也提供 npx 和 docker 的本地启动命令，步骤清晰、依赖描述明确。扣分：未提供 CI 或测试证据来验证这些步骤的开箱即用；安装依赖 HF 账号/token，并且部分示例使用远程托管的 huggingface.co/mcp，实际连接还需额外认证与网络配置。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

希望在 LLM 工具中集成 Hugging Face 生态的开发者
需要访问模型、数据集和 Gradio 应用的 AI 应用构建者

不适合谁

不使用 Hugging Face 服务的用户
需要长期连接或状态保持的 MCP 服务器场景（STDIO 不支持技能）

所需权限

需要 Hugging Face 令牌（HF_TOKEN）进行认证
HTTP 传输需要 Authorization: Bearer 头
可能访问 Hugging Face API 和 Gradio 应用

风险与副作用

使用用户提供的令牌，可能被滥用
通过代理工具或外部 URL 可能引入安全风险
默认允许本地回环地址，外部访问需配置 allowlist

安装接入

准备工作

运行环境：Node.js · Docker · 远程托管（无需本地环境）

DEFAULT_HF_TOKEN 可选密钥本地 STDIO 部署使用的默认 Hugging Face 访问令牌，在 https://huggingface.co/settings/tokens 获取。

HF_TOKEN 可选密钥 STDIO 传输下 DEFAULT_HF_TOKEN 未设置时的备用 Hugging Face 令牌。

PROXY_TOKEN 可选密钥仅在启动时发现 PROXY_TOOLS_CSV 架构时使用的可选认证令牌。

其他可选配置项（10 个）

TRANSPORT 可选选择传输方式：stdio 或 streamableHttpJson（Docker 默认后者）。

MCP_ALLOWED_HOSTS 可选额外的 MCP/API 路由 Host 允许列表，逗号分隔，支持 *.example.com 通配符。

HF_API_TIMEOUT 可选 Hugging Face API 请求超时毫秒数，默认 12500。

USER_CONFIG_API 可选可选的按用户 MCP 设置 API URL，未设置时使用内置默认值。

ALLOW_INTERNAL_ADDRESS_HOSTS 可选允许解析内部/保留 DNS 的受信任域名白名单，支持精确主机和 * 通配。

MCP_STRICT_COMPLIANCE 可选设为 True 时 JSON 模式对 GET 返回 405（默认返回欢迎页）。

DISABLE_TOOLS 可选逗号分隔的工具名列表，从 tools/list 隐藏并拒绝调用。

PROXY_TOOLS_CSV 可选 HTTPS URL 或本地文件路径，定义启动时加载的 Streamable HTTP 代理工具源。

GRADIO_SKIP_INITIALIZE 可选设为 true 时 Gradio MCP 调用跳过 initialize 握手。

HF_SKILLS_DIR 可选包含预构建技能快照的本地目录，默认 /mnt/hf-skills/distribution/latest。

在 Claude Desktop 或 claude.ai 中，点击 README 中的链接或从连接器库添加 'Hugging Face'。
在 Claude Code 中运行：claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login（或使用令牌）。
在 Gemini CLI 中运行：gemini mcp add -t http huggingface https://huggingface.co/mcp?login。
在 VSCode 中，点击 README 中的链接或从 MCP 库安装；也可手动配置 mcp.json。
在 Cursor 中，点击 README 中的安装链接或手动配置。
也可通过 npx 或 Docker 本地运行：npx @llmindset/hf-mcp-server 或 docker run --rm -p 3000:3000 ghcr.io/evalstate/hf-mcp-server:latest。

验证是否装好

在客户端工具列表中应出现 Hugging Face 的工具（如 hub_repo_search、hf_fs 等，除非被 DISABLE_TOOLS 隐藏）。也可通过 npx @llmindset/hf-mcp-server 启动后在 http://localhost:3000/ 的管理界面确认服务器状态与工具指标。

常见排障

检查环境变量是否正确设置，如 TRANSPORT、DEFAULT_HF_TOKEN
确保网络连接可达 Hugging Face 服务
查看服务器管理界面（端口 3000）上的状态和指标
对于 HTTP 请求，确保 Authorization 头包含有效令牌
工具列表为空时，检查 DISABLE_TOOLS 或用户配置

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在 Hugging Face Hub 上搜索与文本转语音相关的模型仓库
使用 hf_fs 列出某个 Hugging Face 数据集仓库中的文件
查找可以运行图像生成的 Gradio AI 应用
获取某个 Hugging Face 数据集的详细信息

使用场景

与 Hugging Face Hub 交互，如搜索模型、数据集、Spaces

通过 Gradio 应用调用 AI 功能

在支持 MCP 的客户端中构建 AI 工作流

支持客户端

Claude Desktop

Claude Code

Gemini CLI

VS Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Hugging Face 官方 MCP 服务器，提供对 Hugging Face Hub API 和搜索端点的 MCP 实现，以及一个用于部署端点的 MCP 服务器和 Web 应用。支持 STDIO 和无状态流式 HTTP JSON 传输，可通过用户配置 API 和查询参数选择工具。