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)整理。