首页 / 开发与效率 / Hugging Face MCP Server

Hugging Face MCP Server

Hugging Face MCP Server是Hugging Face官方提供的MCP 连接器(MCP 服务器),搜索模型、数据集和 Space,查看仓库详情;匿名即可用基础工具,配 Token 解锁语义搜索、文档检索、Jobs 等。

MCP个人可用国内网络:依赖海外服务官方出品

能帮你做什么

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 腾讯
  1. 本站实测(2026-11-19):在 WorkBuddy 中添加自定义连接器,类型选远程 MCP(Streamable HTTP),地址填 https://huggingface.co/mcp。
  2. 在 WorkBuddy 的 CLI 环境里,Streamable HTTP 对应的配置值是 "type": "http",写入 ~/.codebuddy/.mcp.json;桌面端「插件 → MCP 服务器 → 配置 MCP」对应 ~/.workbuddy/mcp.json。
  3. 执行 codebuddy mcp list 检查,显示 huggingface … (HTTP) - ✓ Connected 即连通。
  4. 新开一个会话再使用:本次实测中,会话中途新加的连接器没有出现在当前会话的工具列表里。
  5. 对它说“用 huggingface 连接器搜一下 Qwen 最热门的 5 个模型”。
不带 Token 时只有 hf_whoami、hub_repo_search、hub_repo_details、hf_fs 四个工具。Token 建议用环境变量 HF_TOKEN 引用,不要直接写进配置文件。

查看 WorkBuddy 完整指南 →

CodeBuddy 腾讯云
  1. 打开(或新建)用户级配置文件 ~/.codebuddy/.mcp.json;只想在某个项目里用,就写到项目根目录的 .mcp.json。
  2. 在 mcpServers 下加入下方配置,远程服务可加 "type": "http",本地命令可加 "type": "stdio"。
  3. 也可以把配置保存成文件,用 codebuddy --mcp-config ./mcp.json 启动时加载。
  4. 重新启动 CodeBuddy 会话后即可调用。

配置内容使用上方的通用 MCP 配置。

查看 CodeBuddy 完整指南 →

TRAE 字节跳动
  1. 在 IDE 窗口或 Agent 窗口中,前往「设置 → MCP」。
  2. 点击右上角「添加 → 从市场添加」,在内置 MCP 市场里点「+」并填写 Key 等配置;或选择「添加 → 手动添加」。
  3. 手动添加时,把下方 JSON 配置粘贴到「手动配置」窗口,点击「确认」。
  4. 项目级配置:先在设置中打开「项目级 MCP」开关,再在项目根目录 .trae/mcp.json 中写入配置。

配置内容使用上方的通用 MCP 配置。

查看 TRAE 完整指南 →

Kimi Code 月之暗面
  1. 在 Kimi Code CLI 的终端界面中运行 /mcp-config,交互式新增 MCP Server;或手动编辑 ~/.kimi-code/mcp.json。
  2. 把下方配置写进 mcpServers:含 command 字段的是 stdio,含 url 字段的是 HTTP;旧式 SSE 需加 "transport": "sse"。
  3. 需要 OAuth 的服务运行 /mcp-config login 完成浏览器授权。
  4. 运行 /mcp 查看连接状态;新增的服务只会加入之后新建的会话。

配置内容使用上方的通用 MCP 配置。

查看 Kimi Code 完整指南 →

★ Cursor Anysphere(海外)
  1. 全局可用:在用户目录创建 ~/.cursor/mcp.json;只在某个项目用:在项目里创建 .cursor/mcp.json。
  2. 把下方 mcpServers 配置粘贴进去并保存。
  3. 在侧边栏 Customize 中确认服务已启用,必要时完成 OAuth 登录。

配置内容使用上方的通用 MCP 配置。

查看 Cursor 完整指南 →

Claude Code Anthropic(海外)
  1. 远程服务:claude mcp add --transport http <名称> <URL>
  2. 本地命令:claude mcp add --transport stdio <名称> -- npx <包名>(-- 之后是服务自己的命令和参数)
  3. 需要环境变量时加 --env KEY=value;想在所有项目可用时加 --scope user。

配置内容使用上方的通用 MCP 配置。

查看 Claude Code 完整指南 →

千问办公(QwenWork) 阿里巴巴
  1. 打开千问办公桌面客户端,进入左侧导航「扩展」→「连接器」。
  2. 内置连接器(浏览器、macOS 应用、Microsoft 365 等)在推荐列表中点击「+」并按提示授权。
  3. 集成市场里的连接器(如钉钉、飞书、Notion 等)可一键安装后授权。
  4. 自定义 MCP:点击页面右上角「+ 添加」,可直接粘贴从 MCP 市场复制的 JSON 配置。

配置内容使用上方的通用 MCP 配置。

查看 千问办公(QwenWork) 完整指南 →

豆包工作 字节跳动
  1. 打开豆包工作客户端,点击左侧「插件·技能·伙伴」,进入「插件」页面。
  2. 官方或企业插件:点击目标插件右侧的「连接」,在弹窗中完成授权。
  3. 自定义:点击「插件」页面右上角「+ 添加」→「新建自定义连接器」。
  4. 远程服务选择 HTTP 类型,填写服务器 URL,需要鉴权时在「自定义 Headers」里添加请求头。
  5. 本地程序选择 STDIO 类型,填写运行命令(如 npx)、参数和环境变量后保存。
  6. 在任务对话框输入 / 或 @ 选择插件,或直接描述需求由系统自动匹配。

配置内容使用上方的通用 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(本站实测)。服务方可能随时调整,请以官方最新说明为准。