Hub documentation
Spaces 作为 MCP 服务器
Spaces 作为 MCP 服务器
您可以将任何带有可见 MCP 徽章的公开 Space 暴露为可调用工具,该工具可在任何兼容 MCP 的客户端中使用,您可以添加任意数量的 Space,且无需编写任何代码。
配置您的 MCP 客户端
在您的 Hub MCP 设置 中,选择您的 MCP 客户端(VSCode、Cursor、Claude Code 等),然后按照设置说明进行操作。

使用 MCP 工具需要一个具有 READ 权限的有效 Hugging Face 令牌。如果您没有,请在此处创建一个新的“Read”访问令牌。
将现有的 Space 添加到您的 MCP 工具

- 浏览兼容的 Spaces,以查找可通过 MCP 使用的 Spaces。您也可以在任意 Spaces 卡片上查找灰色的 MCP 徽章。
- 点击徽章,选择 Add to MCP tools,然后在提示时进行确认。
- 该 Space 应显示在您的 MCP Server 设置的 Spaces Tools 部分中。

从您的 MCP 客户端使用 Spaces
如果您的 MCP 客户端配置正确,您添加的 Spaces 将立即可用,无需进行任何更改(如果客户端未重启,它应该会显示出来)。大多数 MCP 客户端会列出当前已加载的工具,以便您确认该 Space 是否可用。
对于 ZeroGPU Spaces,当调用该工具时会消耗您的配额。如果配额用尽,您可以订阅 PRO,以获得每天 40 分钟的配额(比免费用户多 8 倍)。例如,您的 PRO 账户每天最多可使用 FLUX.1-schnell 生成 600 张图片。
构建你自己的兼容 MCP 的 Gradio Space
要创建自己的支持 MCP 的 Space,您需要先创建一个新的 Gradio Space,然后在代码中确保启用 MCP 支持。从Gradio Spaces开始入门,并务必查阅详细的 MCP 指南以获取更多详细信息。
首先,安装支持 MCP 的 Gradio:
pip install "gradio[mcp]"然后创建你的应用,并添加清晰的类型提示和文档字符串:
import gradio as gr
def letter_counter(word: str, letter: str) -> int:
"""Count occurrences of a letter in a word.
Args:
word: The word to search in
letter: The letter to count
Returns:
Number of times the letter appears in the word
"""
return word.lower().count(letter.lower())
demo = gr.Interface(fn=letter_counter,
inputs=["text", "text"],
outputs="number")
demo.launch(mcp_server=True) # exposes an MCP schema automatically将应用推送到 Gradio Space,它会自动获得 MCP 徽章。之后,任何人都可以一键将其添加为工具。
将现有的 Gradio Space 转换为 MCP 服务器也相当简单。从上下文菜单中将其复制,然后在
launch()方法中添加mcp_server=True参数,并确保你的函数具有清晰的类型提示和文档字符串——你可以使用 AI 工具轻松实现自动化(示例:AI 生成的文档字符串)。
通过混合使用 Spaces 来发挥创意!
由于 Hugging Face Spaces 是最大的 AI 应用目录,您可以在其中找到许多可用作 MCP 工具的创意工具。将不同的 Spaces 进行组合和搭配,可以构建出强大且富有创意的流程。