Hugging Face MCP 服务器
Hugging Face MCP（Model Context Protocol，模型上下文协议）Server 将你的 MCP 兼容 AI 助手（例如 Codex、Cursor、VS Code 扩展、Zed、ChatGPT 或 Claude Desktop）直接连接到 Hugging Face Hub。连接后，你的助手可以搜索和探索 Hub 资源并使用社区工具，所有这些都可以在你的编辑器、聊天或 CLI 中完成。
你可以做什么
- 搜索和探索 Hub 资源：模型、数据集、Spaces 和论文。
- 通过托管在 Spaces 上的 MCP 兼容 Gradio 应用运行社区工具。
- 将结果（元数据、链接和上下文）带回你的助手。
开始使用
-
打开你的 MCP 设置：登录后访问 https://huggingface.co/settings/mcp。
-
选择你的客户端：选择你的 MCP 兼容客户端（例如 Cursor、VS Code、Zed、Claude Desktop）。页面会显示特定于客户端的说明和可直接复制的配置片段。
-
粘贴并重启：将片段复制到客户端的 MCP 配置中，保存，然后重启/重新加载客户端。你应该在客户端中看到 "Hugging Face"（或类似名称）被列为已连接的 MCP 服务器。
设置页面会生成客户端期望的确切配置。使用它而不是手动编写配置。
使用服务器
连接后，请你的助手使用 Hugging Face 工具。示例提示：
- "搜索 Hugging Face 模型中的 Qwen 3 量化版本。"
- "找到一个可以转录音频文件的 Space。"
- "显示关于天气时间序列的数据集。"
- "创建一张 1024 x 1024 像素的吉卜力风格猫咪图片。"
你的助手将调用 Hugging Face MCP Server（包括 Spaces）暴露的 MCP 工具，并返回结果（标题、所有者、下载量、链接等）。然后你可以在 Hub 上打开资源，或在同一聊天中继续迭代。
添加社区工具（Spaces）
你可以使用社区构建的 MCP 兼容 Gradio Spaces 扩展你的设置：
- 在此处探索支持 MCP 的 Spaces：https://huggingface.co/spaces?filter=mcp-server。
- 在 Hugging Face 的 MCP 设置中添加相关 Space：https://huggingface.co/settings/mcp。
Gradio MCP 应用将其函数暴露为工具（包含参数和描述），因此你的助手可以直接调用它们。请重启或刷新客户端，以便它识别你添加的新工具。
查看我们关于 Spaces 作为 MCP 服务器的专门指南：https://huggingface.co/docs/hub/spaces-mcp-servers#add-an-existing-space-to-your-mcp-tools。
了解更多
- 设置和客户端配置：https://huggingface.co/settings/mcp
- 更新日志公告：https://huggingface.co/changelog/hf-mcp-server
- Hugging Face MCP Server：https://huggingface.co/mcp
- 使用 Gradio Spaces 构建你自己的 MCP Server：https://www.gradio.app/guides/building-mcp-server-with-gradio