Hugging Face MCP Server
Hugging Face MCP Server是Hugging Face官方提供的MCP 连接器(MCP 服务器),搜索模型、数据集和 Space,查看仓库详情;匿名即可用基础工具,配 Token 解锁语义搜索、文档检索、Jobs 等。
能帮你做什么
Hugging Face 官方提供托管的远程 MCP 服务,地址是 https://huggingface.co/mcp,传输方式为 Streamable HTTP。连接后,智能体可以在 Hub 上搜索模型、数据集和 Space,查看仓库的卡片信息、许可证、下载量和文件列表。
匿名与登录的区别(本站实测)
- 匿名:服务端返回 4 个工具:hf_whoami、hub_repo_search、hub_repo_details、hf_fs,并提示匿名调用有速率限制。
- 带 Token:在请求头加 Authorization: Bearer
(Read 权限即可),可以解除限流、访问门控仓库,并开放 Space / 论文语义搜索、文档检索、Jobs 等工具。工具开关在 Hugging Face 账号的 MCP 设置页里调整。 - 支持标准 MCP OAuth 的客户端可以改用 https://huggingface.co/mcp?login,省去手动管理 Token。
国内能不能用
这是本站的一个实测发现:同一个海外连接器,在云端智能体和本地智能体里的结果可能不同。 WorkBuddy 的任务跑在云端沙箱,实测可以直接连通 huggingface.co;而 TRAE、Cursor 这类在你电脑上运行的智能体,走的是你自己的网络。详见实测文章。
安装方法
通用 MCP 配置(来自官方文档,把占位符换成你自己的 Key / 路径):
{
"mcpServers": {
"huggingface": {
"type": "http",
"url": "https://huggingface.co/mcp",
"headers": {
"Authorization": "Bearer ${HF_TOKEN}"
}
}
}
}按智能体查看步骤。标 ★ 的是官方文档明确列出的客户端;其余按该智能体的通用 MCP 接入方式整理,本站尚未逐一实测。
WorkBuddy 腾讯
- 本站实测(2026-11-19):在 WorkBuddy 中添加自定义连接器,类型选远程 MCP(Streamable HTTP),地址填 https://huggingface.co/mcp。
- 在 WorkBuddy 的 CLI 环境里,Streamable HTTP 对应的配置值是 "type": "http",写入 ~/.codebuddy/.mcp.json;桌面端「插件 → MCP 服务器 → 配置 MCP」对应 ~/.workbuddy/mcp.json。
- 执行 codebuddy mcp list 检查,显示 huggingface … (HTTP) - ✓ Connected 即连通。
- 新开一个会话再使用:本次实测中,会话中途新加的连接器没有出现在当前会话的工具列表里。
- 对它说“用 huggingface 连接器搜一下 Qwen 最热门的 5 个模型”。
CodeBuddy 腾讯云
- 打开(或新建)用户级配置文件 ~/.codebuddy/.mcp.json;只想在某个项目里用,就写到项目根目录的 .mcp.json。
- 在 mcpServers 下加入下方配置,远程服务可加 "type": "http",本地命令可加 "type": "stdio"。
- 也可以把配置保存成文件,用 codebuddy --mcp-config ./mcp.json 启动时加载。
- 重新启动 CodeBuddy 会话后即可调用。
配置内容使用上方的通用 MCP 配置。
TRAE 字节跳动
- 在 IDE 窗口或 Agent 窗口中,前往「设置 → MCP」。
- 点击右上角「添加 → 从市场添加」,在内置 MCP 市场里点「+」并填写 Key 等配置;或选择「添加 → 手动添加」。
- 手动添加时,把下方 JSON 配置粘贴到「手动配置」窗口,点击「确认」。
- 项目级配置:先在设置中打开「项目级 MCP」开关,再在项目根目录 .trae/mcp.json 中写入配置。
配置内容使用上方的通用 MCP 配置。
Kimi Code 月之暗面
- 在 Kimi Code CLI 的终端界面中运行 /mcp-config,交互式新增 MCP Server;或手动编辑 ~/.kimi-code/mcp.json。
- 把下方配置写进 mcpServers:含 command 字段的是 stdio,含 url 字段的是 HTTP;旧式 SSE 需加 "transport": "sse"。
- 需要 OAuth 的服务运行 /mcp-config login 完成浏览器授权。
- 运行 /mcp 查看连接状态;新增的服务只会加入之后新建的会话。
配置内容使用上方的通用 MCP 配置。
★ Cursor Anysphere(海外)
- 全局可用:在用户目录创建 ~/.cursor/mcp.json;只在某个项目用:在项目里创建 .cursor/mcp.json。
- 把下方 mcpServers 配置粘贴进去并保存。
- 在侧边栏 Customize 中确认服务已启用,必要时完成 OAuth 登录。
配置内容使用上方的通用 MCP 配置。
Claude Code Anthropic(海外)
- 远程服务:claude mcp add --transport http <名称> <URL>
- 本地命令:claude mcp add --transport stdio <名称> -- npx <包名>(-- 之后是服务自己的命令和参数)
- 需要环境变量时加 --env KEY=value;想在所有项目可用时加 --scope user。
配置内容使用上方的通用 MCP 配置。
千问办公(QwenWork) 阿里巴巴
- 打开千问办公桌面客户端,进入左侧导航「扩展」→「连接器」。
- 内置连接器(浏览器、macOS 应用、Microsoft 365 等)在推荐列表中点击「+」并按提示授权。
- 集成市场里的连接器(如钉钉、飞书、Notion 等)可一键安装后授权。
- 自定义 MCP:点击页面右上角「+ 添加」,可直接粘贴从 MCP 市场复制的 JSON 配置。
配置内容使用上方的通用 MCP 配置。
豆包工作 字节跳动
- 打开豆包工作客户端,点击左侧「插件·技能·伙伴」,进入「插件」页面。
- 官方或企业插件:点击目标插件右侧的「连接」,在弹窗中完成授权。
- 自定义:点击「插件」页面右上角「+ 添加」→「新建自定义连接器」。
- 远程服务选择 HTTP 类型,填写服务器 URL,需要鉴权时在「自定义 Headers」里添加请求头。
- 本地程序选择 STDIO 类型,填写运行命令(如 npx)、参数和环境变量后保存。
- 在任务对话框输入 / 或 @ 选择插件,或直接描述需求由系统自动匹配。
配置内容使用上方的通用 MCP 配置。
Hugging Face MCP Server 常见问题
Hugging Face MCP Server是什么?
Hugging Face MCP Server是Hugging Face官方提供的MCP 连接器(MCP 服务器),搜索模型、数据集和 Space,查看仓库详情;匿名即可用基础工具,配 Token 解锁语义搜索、文档检索、Jobs 等。
Hugging Face MCP Server个人能用吗?收费吗?
个人可用。使用门槛:匿名可用 4 个基础工具(有速率限制);用 Read 权限的 Access Token 可解除限流并开放更多工具。
Hugging Face MCP Server在国内网络能直接用吗?
依赖海外服务。服务地址 huggingface.co 为海外服务。本站实测:WorkBuddy 的云端沙箱可以直接连通;本地运行的智能体走的是你本机的网络,能否连通取决于本机网络环境。
哪些智能体可以使用Hugging Face MCP Server?
本站整理了 WorkBuddy、CodeBuddy、TRAE、Kimi Code、Cursor、Claude Code、千问办公(QwenWork)、豆包工作 的安装方法,其中 Cursor 为官方文档明确列出的客户端。
Hugging Face MCP Server的信息来源是什么?
本页依据 Hugging Face 文档:Hugging Face MCP Server;GitHub:huggingface/hf-mcp-server 整理,最后核对于 2026-11-19。
官方来源
本页由智能体连接器(lianjieqi.ai)整理,依据以上公开来源原创撰写,最后核对于 2026-11-19(本站实测)。服务方可能随时调整,请以官方最新说明为准。