适合谁
- 希望在 LLM 工具中集成 Hugging Face 生态的开发者
- 需要访问模型、数据集和 Gradio 应用的 AI 应用构建者
H
57FMRS · C
Hugging Face 官方 MCP 服务器，功能丰富，支持多种客户端和传输方式，适合集成 Hugging Face 生态。
Hugging Face 官方 MCP 服务器，提供对 Hugging Face Hub API 和搜索端点的 MCP 实现，以及一个用于部署端点的 MCP 服务器和 Web 应用。支持 STDIO 和无状态流式 HTTP JSON 传输，可通过用户配置 API 和查询参数选择工具。
工具能力
暂未整理工具清单。
安装接入
- 在 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 服务的用户
- 需要长期连接或状态保持的 MCP 服务器场景（STDIO 不支持技能）
所需权限
- 需要 Hugging Face 令牌（HF_TOKEN）进行认证
- HTTP 传输需要 Authorization: Bearer 头
- 可能访问 Hugging Face API 和 Gradio 应用
风险与副作用
- 使用用户提供的令牌，可能被滥用
- 通过代理工具或外部 URL 可能引入安全风险
- 默认允许本地回环地址，外部访问需配置 allowlist
常见排障
- 检查环境变量是否正确设置，如 TRANSPORT、DEFAULT_HF_TOKEN
- 确保网络连接可达 Hugging Face 服务
- 查看服务器管理界面（端口 3000）上的状态和指标
- 对于 HTTP 请求，确保 Authorization 头包含有效令牌
- 工具列表为空时，检查 DISABLE_TOOLS 或用户配置
使用场景
与 Hugging Face Hub 交互，如搜索模型、数据集、Spaces
通过 Gradio 应用调用 AI 功能
在支持 MCP 的客户端中构建 AI 工作流
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Gemini CLI完整支持
VSCode完整支持
Cursor完整支持