首页 / 实测文章 / 实测
实测

WorkBuddy 能用 Hugging Face 连接器吗?实测:云端沙箱可直连

发布于 2026-11-19

测试日期:2026-11-19(北京时间) 测试人:本站 结论:能用

Hugging Face 是全球最大的开源模型社区,官方提供了一个远程 MCP 服务。它的服务器在海外,我们想知道:国内的办公智能体 WorkBuddy 能不能用上它?

测试配置

在 WorkBuddy 里添加自定义连接器,地址 https://huggingface.co/mcp,类型选远程 MCP(Streamable HTTP),不填 Token。WorkBuddy 写入的配置如下(文件 ~/.codebuddy/.mcp.json,原有配置保留):

{
  "mcpServers": {
    "huggingface": {
      "type": "http",
      "url": "https://huggingface.co/mcp",
      "description": "Hugging Face Hub 官方 MCP(Streamable HTTP)",
      "timeout": 60000
    }
  }
}

注意:在这个环境里,Streamable HTTP 对应的值写 "type": "http",和 CodeBuddy 的 MCP 文档一致。如果在 WorkBuddy 桌面端「插件 → MCP 服务器 → 配置 MCP」里填写,用户级配置文件是 ~/.workbuddy/mcp.json。

测试结果

检查项 结果
codebuddy mcp list 健康检查 ✅ huggingface: https://huggingface.co/mcp (HTTP) - ✓ Connected
握手(initialize) ✅ HTTP 200,服务端返回会话 ID
获取工具列表 ✅ 匿名可用 4 个:hf_whoami、hub_repo_search、hub_repo_details、hf_fs
实际任务:搜 Qwen 最热门的 5 个模型 ✅ 按下载量返回了 Qwen 官方组织的前 5 个模型

实际任务的回复(按下载量排序,数据为测试当时的实时统计):

# 模型 任务 下载量
1 Qwen3-0.6B 文本生成 约 1600 万
2 Qwen3-14B 文本生成 约 1320 万
3 Qwen3-Embedding-0.6B 向量嵌入 约 790 万
4 Qwen3.8-27B 图文多模态 约 690 万
5 Qwen2.5-7B-Instruct 文本生成 约 650 万

两个踩坑点

1. 新加的连接器要开新会话。 我们是在会话进行中添加的连接器,它没有出现在当前会话的工具列表里。这次 WorkBuddy 自己绕了一步,直接和 MCP 端点握手后调用了搜索工具。普通用户遇到这种情况,很可能以为没装上。加完连接器后,新开一个会话再用。

2. 匿名能用,但功能受限。 服务端明确提示匿名调用有速率限制,只开放基础工具。想用模型、数据集、Space、论文的语义搜索,文档检索和 Jobs 等功能,需要在请求头里带上 Hugging Face 的 Access Token(Read 权限即可):

"headers": { "Authorization": "Bearer ${HF_TOKEN}" }

Token 建议用环境变量保存,不要直接写进配置文件。支持标准 MCP OAuth 的客户端也可以用 https://huggingface.co/mcp?login。

为什么能连上

WorkBuddy 的任务运行在腾讯云的云端沙箱里,连接器的请求是从那台云端机器发出去的,用的是云端机器的网络,而不是你自己电脑的网络。这次测试说明它所在的环境可以访问 huggingface.co。

这引出一个很实用的结论:判断一个海外连接器“国内能不能用”,要分智能体类型来看。

  • 云端智能体(如这次的 WorkBuddy 沙箱):取决于厂商云端环境的网络,本次实测可以连通。
  • 本地智能体(如 TRAE、Cursor、Claude Code):请求从你的电脑发出,取决于你本机的网络环境。

反过来,像 ACE Studio 这种必须在本机运行的连接器,云端智能体就用不了。两类智能体各有适合的连接器。

连接器详情和各智能体的配置方法见 Hugging Face MCP Server。

本文由智能体连接器(lianjieqi.ai)整理。

参考来源